wcsstr(3C)




NAME

     wcsstr - find a wide-character substring


SYNOPSIS

     #include <wchar.h>

     wchar_t *wcsstr(const wchar_t *ws1, const wchar_t *ws2);

  ISO C++
     #include <wchar.h>

     const wchar_t  *wcsstr(const  wchar_t  *ws1,  const  wchar_t
     *ws2);

     #include <cwchar>

     wchar_t *std::wcsstr(wchar_t *ws1, const wchar_t *ws2);


DESCRIPTION

     The wcsstr() function locates the first  occurrence  in  the
     wide-character  string  pointed to by ws1 of the sequence of
     wide-characters  (excluding  the  terminating   null   wide-
     character) in the wide-character string pointed to by ws2.


RETURN VALUES

     On successful completion,  wcsstr() returns a pointer to the
     located  wide-character  string,  or  a  null pointer if the
     wide-character string is not found.

     If ws2 points to a wide-character string with  zero  length,
     the function returns ws1.


ERRORS

     No errors are defined.


ATTRIBUTES

     See attributes(5) for descriptions of the  following  attri-
     butes:

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | MT-Level                    | MT-Safe                     |
    |_____________________________|_____________________________|


SEE ALSO

     wschr(3C), attributes(5)


Man(1) output converted with man2html