wcsstr — find a wide-character substring
#include <wchar.h>
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-2024 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.
[CX] The wcsstr() function shall not change the setting of errno on valid input.
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.
None.
None.
None.
None.
XBD <wchar.h>
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.
Austin Group Defect 448 is applied, adding a requirement that wcsstr() does not change the setting of errno on valid input.
return to top of page