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 Functionswmemchr(3C)


NAME

 wmemchr - find a wide-character in memory

SYNOPSIS

 
#include <wchar.h>
wchar_t *wmemchr(const wchar_t *ws, wchar_t wc, size_t n);

ISO C++

 
 
#include <wchar.h>
const wchar_t *wmemchr(const wchar_t *ws, wchar_t wc, size_t n);
 
#include <cwchar>
wchar_t *std::wmemchr(wchar_t *ws, wchar_t wc, size_t n);

DESCRIPTION

 

The wmemchr() function locates the first occurrence of wc in the initial n wide-characters of the object pointed to be ws. This function is not affected by locale and all wchar_t values are treated identically. The null wide-character and wchar_t values not corresponding to valid characters are not treated specially.

If n is 0, ws must be a valid pointer and the function behaves as if no valid occurrence of wc is found.

RETURN VALUES

 

The wmemchr() function returns a pointer to the located wide-character, or a null pointer if the wide-character does not occur in the object.

ERRORS

 

No errors are defined.

ATTRIBUTES

 

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPEATTRIBUTE VALUE
MT-LevelMT-Safe

SEE ALSO

 

wmemcmp(3C), wmemcpy(3C), wmemmove(3C), wmemset(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.