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)
