WSTRING(3) BSD Programmer's Manual WSTRING(3)NAME
wcscat, wcschr, wcscmp, wcscpy, wcscspn, wcsftime, wcslen, wcsncat,
wcsncmp, wcsncpy, wcspbrk, wcsrchr, wcsspn, wcswcs - standard string op-
erations on wide-character strings
SYNOPSIS
#include <wchar.h>
wchar_t *
wcscat(wchar_t *ws1, wchar_t *ws2);
wchar_t *
wcschr(wchar_t *ws1, wchar_t wc);
int
wcscmp(wchar_t *ws1, wchar_t *ws2);
wchar_t *
wcscpy(wchar_t *ws1, wchar_t *ws2);
size_t
wcscspn(wchar_t *ws1, wchar_t *ws2);
size_t
wcsftime(wchar_t *wcs, size_t maxsize, char *format, struct tm *timeptr);
size_t
wcslen(wchar_t *ws);
wchar_t *
wcsncat(wchar_t *ws1, wchar_t *ws2, int n);
int
wcsncmp(wchar_t *ws1, wchar_t *ws2, int n);
wchar_t *
wcsncpy(wchar_t *ws1, wchar_t *ws2, int n);
wchar_t *
wcspbrk(wchar_t *ws1, wchar_t *ws2);
wchar_t *
wcsrchr(wchar_t *ws1, wchar_t wc);
size_t
wcssspn(wchar_t *ws1, wchar_t *ws2);
wchar_t *
wcswcs(wchar_t *ws1, wchar_t wc);
DESCRIPTION
These wide-character (wcs) routines are analogous to the narrow-character
``str'' routines. Please see the manual pages for the ``str'' routines
for a description of these operations. The analogous ``str'' routine
name is determined by replacing all occurrences of the string ``wcs''
with ``str'' in the name (e.g., wcschr becomes strchr and wcswcs becomes
strstr). Rather than operating on narrow-character (char *) strings,
these routines operate on wide-character (wchar_t *) strings. When an
individual character is passed as an argument it is a wide-character
(wchar_t) rather than a narrow-character (char). All sizes are returned
as the number of wide-characters and not as the number of bytes.
SEE ALSOstring(3)