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);

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 zero, ws must be a valid pointer and the function behaves as if no valid occurrence of wc is found.

RETURN VALUE

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.

EXAMPLES

None.

APPLICATION USAGE

None.

FUTURE DIRECTIONS

None.

SEE ALSO

<wchar.h> , wmemcmp(3) , wmemcpy(3) , wmemmove(3) , wmemset(3) .

DERIVATION

Derived from the ISO/IEC 9899/AMD1:1995 (“ISO C90, Amendment 1”) (E).