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(), <wchar.h>.

DERIVATION

Derived from the ISO/IEC 9899:1990/Amendment 1:1995 (E).