man pages section 3: Basic Library Functions

Exit Print View

Updated: July 2014
 
 

wmemchr(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 TYPE
ATTRIBUTE VALUE
Interface Stability
Committed
MT-Level
MT-Safe
Standard

See Also

wmemcmp(3C), wmemcpy(3C), wmemmove(3C), wmemset(3C), attributes(5), standards(5)