NAME
wcsstr — find a
wide-character substring
SYNOPSIS
#include
<wchar.h>
wchar_t *wcsstr(const wchar_t *restrict ws1,
const wchar_t *restrict ws2);
DESCRIPTION
[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.
RETURN VALUE
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.
ERRORS
No errors are defined.
EXAMPLES
None.
APPLICATION USAGE
None.
RATIONALE
None.
FUTURE DIRECTIONS
None.
SEE ALSO
XBD <wchar.h>
CHANGE HISTORY
First released in Issue 5. Included for alignment with ISO/IEC 9899/AMD1:1995 (“ISO C90, Amendment 1”) (E).
Issue 6
The wcsstr () prototype is updated for
alignment with the ISO/IEC 9899:1999
(“ISO C99”) standard.
Issue 8
Austin Group Defect 448 is applied, adding a requirement that
wcsstr () does not change the setting of
errno on valid input.