Standard C++ Library Reference ISO/IEC (VERSION3)

any shift sequence needed to restore the initial shift state. followed by a null byte. The resulting conversion
state is the initial conversion state.
If s is a null pointer, the function effectively returns wcrtomb(buf, L'\0', ps), where buf is a
buffer internal to the function. (The function thus returns the number of bytes needed to restore the initial
conversion state and to terminate the multibyte string pending from a previous call to wcrtomb or
wcsrtombs for the same string and conversion state.)
The function returns:
(size_t)-1 if wc is an invalid wide-character code, in which case the function stores the value
EILSEQ in errno and leaves the resulting conversion state undefined
●
x, the number of bytes needed to complete the next muitibyte character, in which case the resulting
conversion state indicates that x bytes have been generated
●
wcscat
wchar_t *wcscat(wchar_t *s1, const wchar_t *s2);
The function copies the wide string s2, including its terminating null wide character, to successive
elements of the array that stores the wide string s1, beginning with the element that stores the terminating
null wide character of s1. It returns s1.
wcschr
wchar_t *wcschr(const wchar_t *s, wchar_t c); [not in C++]
const wchar_t *wcschr(const wchar_t *s, wchar_t c); [C++ only]
wchar_t *wcschr(wchar_t *s, wchar_t c); [C++ only]
The function searches for the first element of the wide string s that equals c. It considers the terminating
null wide character as part of the wide string. If successful, the function returns the address of the matching
element; otherwise, it returns a null pointer.
wcscmp
int wcscmp(const wchar_t *s1, const wchar_t *s2);
The function compares successive elements from two wide strings, s1 and s2, until it finds elements that
are not equal.
If all elements are equal, the function returns zero.●
If the differing element from s1 is greater than the element from s2, the function returns a positive
number.
●
Otherwise, the function returns a negative number.●
wcscoll
int wcscoll(const wchar_t *s1, const wchar_t *s2);