wcsstr()

Find one string inside another

Synopsis:

#include <wchar.h>

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

Library:

libc

Description:

The wcsstr() function locates the first occurrence in the string pointed to by ws1 of the sequence of wide characters, excluding the terminating NUL, in the string pointed to by ws2.

Returns:

NULL: Failure; no string found.
The same pointer as ws2: The argument ws2 points to a zero-length string.
x: Success; a pointer to the located string.

Classification:

Safety:
Cancellation point	No
Interrupt handler	Yes
Signal handler	Yes
Thread	Yes

See also:

"Searching and sorting functions", "String manipulation functions", and "Wide-character functions" in the summary of functions chapter.