[ Bottom of Page | Previous Page | Next Page | Contents | Index | Library Home | Legal | Search ]

Technical Reference: Base Operating System and Extensions, Volume 2

wmemchr Subroutine

Purpose

Find a wide-character in memory.

Library

Standard library (libc.a)

Syntax

#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 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.

Related Information

The wmemcmp (wmemcmp Subroutine) subroutine, wmemcpy (wmemcpy Subroutine) subroutine, wmemmove (wmemmove Subroutine) subroutine, wmemset (wmemset Subroutine) subroutine.

[ Top of Page | Previous Page | Next Page | Contents | Index | Library Home | Legal | Search ]