NAME

       wcsstr - locate a substring in a wide-character string

LIBRARY

       Standard C library (libc, -lc)

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 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.

ATTRIBUTES

       For an explanation of the terms used in this section, see attributes(7).
       ┌─────────────────────────────────────────────────────────────────────────────┬───────────────┬─────────┐
       │ Interface                                                                   │ Attribute     │ Value   │
       ├─────────────────────────────────────────────────────────────────────────────┼───────────────┼─────────┤
       │ wcsstr()                                                                    │ Thread safety │ MT-Safe │
       └─────────────────────────────────────────────────────────────────────────────┴───────────────┴─────────┘

STANDARDS

       C11, POSIX.1-2008.

HISTORY

       POSIX.1-2001, C99.

SEE ALSO

       strstr(3), wcschr(3)

Linux man-pages 6.7                                2023-10-31                                          wcsstr(3)