NAME    [Toc]    [Back]

       wcsstr - Find a wide-character substring

SYNOPSIS    [Toc]    [Back]

       #include <wchar.h>

       char_t *wcsstr(
               const wchar_t *s1,
               const wchar_t *s2 );

LIBRARY    [Toc]    [Back]

       Standard C Library (libc)

STANDARDS    [Toc]    [Back]

       Interfaces  documented  on  this reference page conform to
       industry standards as follows:

       wcsstr(): XSH5.0

       Refer to the standards(5) reference page for more information
 about industry standards and associated tags.

PARAMETERS    [Toc]    [Back]

       Specifies the wide-character string being searched.  Specifies
 the wide-character substring to be located.

DESCRIPTION    [Toc]    [Back]

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

RETURN VALUES    [Toc]    [Back]

       Upon successful completion, the wcsstr() function  returns
       a  pointer  to  the  located wide-character substring or a
       null pointer when the substring is not found.  If  the  s2
       parameter  points  to  a wide-character substring having 0
       (zero) length, the wcsstr() function  returns  the  entire
       wide-character string pointed to by parameter s1.

       [Tru64  UNIX]  On  error,  the  function  returns  a  null
       pointer.

SEE ALSO    [Toc]    [Back]

       Functions: strstr(3), wcswcs(3)

       Standards: standards(5)



                                                        wcsstr(3)