wmemchr | Programming Place Plus　Ｃ言語編　標準ライブラリのリファレンス

概要

メモリ上から、特定のワイド文字を探す。

ヘッダ

wchar.h

形式

wchar_t* wmemchr(const wchar_t* s, wchar_t c, size_t n);

引数

s

探索するメモリの先頭のメモリアドレス。

c

探索するワイド文字。

n

探索する文字数。

戻り値

発見された場合は、メモリ上のそのワイド文字を指すポインタ。
発見できなかった場合は、ヌルポインタ。

詳細

引数s が指す位置を先頭として、そこから 引数n の文字数分の範囲を探索し、引数c と一致するものを探す。

注意

探索対象を表す引数s は const であるのにも関わらず、戻り値は非const のポインタである。そのため、実引数にワイド文字列リテラルを渡した場合に、戻り値で得られたポインタを経由してワイド文字を変更するプログラムはコンパイルが通るが、動作は未定義になる。

使用例

#include <stdio.h>
#include <wchar.h>

int main(void)
{
    const wchar_t str[] = L"abc\0def";

    const wchar_t* p = wmemchr(str, L'd', sizeof(str)/sizeof(str[0]));
    if (p == NULL) {
        puts("見つからない。");
    }
    else {
        wprintf(L"%ls\n", p);
    }
}

実行結果：

def

関連

ワイド文字列からの探索に特化した wcschr関数がある。
メモリ上からマルチバイト文字を検索する memchr関数がある。

解説章