1WCSSTR(3) Linux Programmer's Manual WCSSTR(3)
2
3
4
6 wcsstr - locate a substring in a wide-character string
7
9 #include <wchar.h>
10
11 wchar_t *wcsstr(const wchar_t *haystack, const wchar_t *needle);
12
14 The wcsstr() function is the wide-character equivalent of the strstr(3)
15 function. It searches for the first occurrence of the wide-character
16 string needle (without its terminating null wide character (L'\0')) as
17 a substring in the wide-character string haystack.
18
20 The wcsstr() function returns a pointer to the first occurrence of nee‐
21 dle in haystack. It returns NULL if needle does not occur as a sub‐
22 string in haystack.
23
24 Note the special case: If needle is the empty wide-character string,
25 the return value is always haystack itself.
26
28 For an explanation of the terms used in this section, see at‐
29 tributes(7).
30
31 ┌────────────────────────────────────────────┬───────────────┬─────────┐
32 │Interface │ Attribute │ Value │
33 ├────────────────────────────────────────────┼───────────────┼─────────┤
34 │wcsstr() │ Thread safety │ MT-Safe │
35 └────────────────────────────────────────────┴───────────────┴─────────┘
36
38 POSIX.1-2001, POSIX.1-2008, C99.
39
41 strstr(3), wcschr(3)
42
44 This page is part of release 5.12 of the Linux man-pages project. A
45 description of the project, information about reporting bugs, and the
46 latest version of this page, can be found at
47 https://www.kernel.org/doc/man-pages/.
48
49
50
51GNU 2021-03-22 WCSSTR(3)