GENWiki

WCSSTR(3) Linux Programmer's Manual WCSSTR(3)

NAME

     wcsstr - locate a substring in a wide-character string

SYNOPSIS

     #include <wchar.h>

     wchar_t *wcsstr(const wchar_t *haystack, const wchar_t *needle);

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.

RETURN VALUE

     The wcsstr() function returns a pointer to the first occurrence of nee-
     dle  in  haystack.   It returns NULL if needle does not occur as a sub-
     string in haystack.

     Note the special case: If needle is the  empty  wide-character  string,
     the return value is always haystack itself.

ATTRIBUTES

     For   an   explanation   of   the  terms  used  in  this  section,  see
     attributes(7).

     +----------+---------------+---------+
     |Interface | Attribute     | Value   |
     +----------+---------------+---------+
     |wcsstr()  | Thread safety | MT-Safe |
     +----------+---------------+---------+

CONFORMING TO

     POSIX.1-2001, POSIX.1-2008, C99.

SEE ALSO

     strstr(3), wcschr(3)

COLOPHON

     This page is part of release 4.16 of the Linux  man-pages  project.   A
     description  of  the project, information about reporting bugs, and the
     latest    version    of    this    page,    can     be     found     at
     https://www.kernel.org/doc/man-pages/.

GNU 2015-08-08 WCSSTR(3)