WCSWCS(3) Library Functions Manual WCSWCS(3)

wcswcs — find a wide substring (LEGACY)


#include <wchar.h>

wchar_t *wcswcs(const wchar_t *ws1, const wchar_t *ws2);

The wcswcs () function shall locate the first occurrence in the wide-character string pointed to by ws1 of the sequence of wide-character codes (excluding the terminating null wide-character code) in the wide-character string pointed to by ws2.

Upon successful completion, wcswcs () 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.

This function was not included in the final ISO/IEC 9899/AMD1:1995 (“ISO C90, Amendment 1”) (E). Application developers are strongly encouraged to use the wcsstr(3) function instead.

None.

This function may be withdrawn in a future version.

wcschr(3), wcsstr(3), the Base Definitions volume of IEEE Std 1003.1-2001 (“POSIX.1”), <wchar.h>

First released in Issue 4. Derived from the MSE working draft.

Marked EX.

This function is marked LEGACY.

footer end

December 6, 2001 posix.fail