wcsstr - locate a substring in a wide-character string
Contents
Attributes
For an explanation of the terms used in this section, see attributes(7).
┌─────────────────────────────────────────────────────────────────────────────┬───────────────┬─────────┐
│ Interface │ Attribute │ Value │
├─────────────────────────────────────────────────────────────────────────────┼───────────────┼─────────┤
│ wcsstr() │ Thread safety │ MT-Safe │
└─────────────────────────────────────────────────────────────────────────────┴───────────────┴─────────┘
Description
The wcsstr() function is the wide-character equivalent of the strstr(3) function. It searches for the
first occurrence of the wide-character string needle (without its terminating null wide character
(L'\0')) as a substring in the wide-character string haystack.
History
POSIX.1-2001, C99.
Library
Standard C library (libc, -lc)
Name
wcsstr - locate a substring in a wide-character string
Return Value
The wcsstr() function returns a pointer to the first occurrence of needle in haystack. It returns NULL
if needle does not occur as a substring in haystack.
Note the special case: If needle is the empty wide-character string, the return value is always haystack
itself.
See Also
strstr(3), wcschr(3) Linux man-pages 6.9.1 2024-06-15 wcsstr(3)
Standards
C11, POSIX.1-2008.
Synopsis
#include<wchar.h>wchar_t*wcsstr(constwchar_t*haystack,constwchar_t*needle);