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(7) for descriptions of the following attributes:
+---------------+-----------------+
|ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+---------------+-----------------+
|MT-Level | MT-Safe |
+---------------+-----------------+
SEE ALSO
malloc(3C),
string(3C),
wcstring(3C),
attributes(7) December 29, 1996 WSTRING(3C)
