NAME

wcsstr — find a wide-character substring

SYNOPSIS

#include <wchar.h>

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

DESCRIPTION

The wcsstr() function locates 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 .

RETURN VALUE

On successful completion, wcsstr() returns 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 returns ws1.

ERRORS

No errors are defined.

EXAMPLES

None.

APPLICATION USAGE

None.

FUTURE DIRECTIONS

None.

SEE ALSO

wcschr(3) , <wchar.h> .

DERIVATION

Derived from the ISO/IEC 9899/AMD1:1995 (“ISO C90, Amendment 1”) (E).