dwww Home | Manual pages | Find package

wcsstr(3)                  Library Functions Manual                  wcsstr(3)

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 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 at-
       tributes(7).

       ┌────────────────────────────────────────────┬───────────────┬─────────┐
       │InterfaceAttributeValue   │
       ├────────────────────────────────────────────┼───────────────┼─────────┤
       │wcsstr()                                    │ Thread safety │ MT-Safe │
       └────────────────────────────────────────────┴───────────────┴─────────┘

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

SEE ALSO
       strstr(3), wcschr(3)

Linux man-pages 6.03              2023-02-05                         wcsstr(3)

Generated by dwww version 1.15 on Wed Jun 26 05:14:23 CEST 2024.