wcsstr - find a wide-character substring
wchar_t *wcsstr(const wchar_t *restrict ws1,
const wchar_t *restrict ws2);
[CX] The functionality described on this reference page is aligned with the ISO C standard. Any conflict between the requirements described here and the ISO C standard is unintentional. This volume of POSIX.1-2017 defers to the ISO C standard.
The wcsstr() function shall locate the first occurrence in the wide-character string pointed to by ws1 of the sequence of wide characters (excluding the terminating null wide character) in the wide-character string pointed to by ws2.
Upon successful completion, wcsstr() shall return a pointer to the located wide-character string, or a null pointer if the wide-character string is not found.
If ws2 points to a wide-character string with zero length, the function shall return ws1.
No errors are defined.
First released in Issue 5. Included for alignment with ISO/IEC 9899:1990/Amendment 1:1995 (E).
The wcsstr() prototype is updated for alignment with the ISO/IEC 9899:1999 standard.
return to top of page