WCSSTR(3C) Standard C Library Functions WCSSTR(3C)

NAME

wcsstr - find a wide-character substring

SYNOPSIS

#include <wchar.h>

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


ISO C++
#include <wchar.h>

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


#include <cwchar>

wchar_t *std::wcsstr(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 VALUES

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.

ATTRIBUTES

See attributes(7) for descriptions of the following attributes:


+--------------------+-----------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+--------------------+-----------------+
|Interface Stability | Standard |
+--------------------+-----------------+
|MT-Level | MT-Safe |
+--------------------+-----------------+

SEE ALSO

wschr(3C), attributes(7), standards(7)


November 14, 2003 WCSSTR(3C)