wstostr(3c) [sunos man page]

strtows(3C)						   Standard C Library Functions 					       strtows(3C)

NAME

       strtows, wstostr - code conversion for Process Code and File Code

SYNOPSIS

       #include <widec.h>

       wchar_t *strtows(wchar_t *dst, const char *src);

       char *wstostr(char *dst, const wchar_t *src);

DESCRIPTION

       The strtows() and wstostr() functions convert strings back and forth between File Code representation and Process Code.

       The  strtows()  function  takes a character string src, converts it to a Process Code string, terminated by a Process Code null, and places
       the result into dst.

       The wstostr() function takes the Process Code string pointed to by src, converts it to a character string, and places the result into dst.

RETURN VALUES

       The strtows() function returns the Process Code string if it completes successfully. Otherwise, a null pointer will be returned	and  errno
       will be set to EILSEQ.

       The wstostr() function returns the File Code string if it completes successfully. Otherwise, a null pointer will be returned and errno will
       be set to EILSEQ.

SEE ALSO

       wstring(3C)

SunOS 5.10							    20 Dec 1996 						       strtows(3C)

wstring(3C)						   Standard C Library Functions 					       wstring(3C)

NAME

       wstring, wscasecmp, wsncasecmp, wsdup, wscol - Process Code string operations

SYNOPSIS

       #include <widec.h>

       int wscasecmp(const wchar_t *s1, const wchar_t *s2);

       int wsncasecmp(const wchar_t *s1, const wchar_t *s2, int n);

       wchar_t *wsdup(const wchar_t *s);

       int wscol(const wchar_t *s);

DESCRIPTION

       These  functions operate on Process Code strings terminated by wchar_t null characters.	During appending or copying, these routines do not
       check for an overflow condition of the receiving string. In the following, s, s1, and s2 point to Process  Code	strings  terminated  by  a
       wchar_t null.

   wscasecmp(), wsncasecmp()
       The  wscasecmp()  function  compares its arguments, ignoring case, and returns an integer greater than, equal to, or less than 0, depending
       upon whether s1 is lexicographically greater than, equal to, or less than s2. It makes the same comparison but compares at most	n  Process
       Code characters. The four Extended Unix Code (EUC) codesets are ordered from lowest to highest as 0, 2, 3, 1 when characters from different
       codesets are compared.

   wsdup()
       The wsdup() function returns a pointer to a new Process Code string, which is a duplicate of the string pointed to by s. The space for  the
       new string is obtained using malloc(3C). If the new string cannot be created, a null pointer is returned.

   wscol()
       The wscol() function returns the screen display width (in columns) of the Process Code string s.

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------------------------------------+
       |ATTRIBUTE TYPE		      ATTRIBUTE VALUE		   |
       |MT-Level		      MT-Safe			   |
       +-----------------------------------------------------------+

SEE ALSO

       malloc(3C), string(3C), wcstring(3C), attributes(5)

SunOS 5.11							    29 Dec 1996 						       wstring(3C)