[ Previous | Next | Table of 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.

Implementation Specifics

This subroutine is part of Base Operating System (BOS) subroutine.

Related Information

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

The wchar.h file.


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