wstring(3scl)wstring(3scl)NAME
wstring, wscasecmp, wsncasecmp, wsdup, wscol - wide character string
operations
LIBRARY
SCL Miscellaneous Library (libsolmisc.so, libsolmisc.a)
SYNOPSIS
#include <widec.h>
int wscasecmp(const wchar_t *str1,
const wchar_t *str2);
int wsncasecmp(const wchar_t *str1,
const wchar_t *str2,
int n);
wchar_t *wsdup(const wchar_t *str);
int wscol(const wchar_t *str);
PARAMETERS
Point to wide character strings terminated with a wchar_t null charac‐
ter Number of characters to compare
DESCRIPTION
The wscasecmp() and wsncasecmp() functions compare their wide-character
string arguments and return an integer greater than, less than or equal
to 0 depending on whether str1 is lexically greater than, less than or
equal to str2. Both functions ignore the case of the character string
during comparison. Function wsncasecmp() only compares up to the number
of characters specified by parameter n.
The wsdup() function makes a duplicate copy of the wide-character
string passed as parameter str. Memory for the new string is obtained
using malloc(3), and a pointer to the new string is returned if suc‐
cessful (or NULL if memory cannot be obtained). It is the responsibil‐
ity of the application to release this memory by calling free(3) when
it is no longer required.
The wscol() function returns the display width, in columns, of the
wide-character string passed in parameter str.
RETURN VALUES
See the Description section for possible return values.
RELATED INFORMATION
Functions: malloc(3), string(3), wcstring(3scl)
Manual: Solaris Compatibility Library User's Guide
wstring(3scl)