Sun Microsystems, Inc.
spacerspacer
spacer   www.sun.com docs.sun.com | | |  
spacer
black dot
   
A   B   C   D   E   F   G   H   I   J   K   L   M   N   O   P   Q   R   S   T   U   V   W   X   Y   Z
    
 
Standard C Library Functionswcsstr(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 attributes:

ATTRIBUTE TYPEATTRIBUTE VALUE
MT-LevelMT-Safe

SEE ALSO

 

wschr(3C), attributes(5)

SunOS 5.9Go To TopLast Changed 11 Nov 1999
 
      
      
Copyright 2002 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms.