1 .\" Copyright (c) Bruno Haible <haible@clisp.cons.org>
3 .\" This is free documentation; you can redistribute it and/or
4 .\" modify it under the terms of the GNU General Public License as
5 .\" published by the Free Software Foundation; either version 2 of
6 .\" the License, or (at your option) any later version.
8 .\" References consulted:
9 .\" GNU glibc-2 source code and manual
10 .\" Dinkumware C library reference http://www.dinkumware.com/
11 .\" OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html
14 .TH WCSSTR 3 2011-09-28 "GNU" "Linux Programmer's Manual"
16 wcsstr \- locate a substring in a wide-character string
21 .BI "wchar_t *wcsstr(const wchar_t *" haystack ", const wchar_t *" needle );
26 function is the wide-character equivalent of the
29 It searches for the first occurrence of the wide-character string
30 \fIneedle\fP (without its terminating null wide character (L\(aq\\0\(aq))
31 as a substring in the wide-character string \fIhaystack\fP.
35 function returns a pointer to the first occurrence of
36 \fIneedle\fP in \fIhaystack\fP.
37 It returns NULL if \fIneedle\fP does not occur
38 as a substring in \fIhaystack\fP.
40 Note the special case:
41 If \fIneedle\fP is the empty wide-character string,
42 the return value is always \fIhaystack\fP itself.