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

トップページC言語編標準ライブラリのリファレンス(名前順)

トップページC言語編標準ライブラリのリファレンス(ヘッダ別)


wcschr関数

概要

ワイド文字列から、特定のワイド文字を探す。

ヘッダ

wchar.h

形式

wchar_t* wcschr(const wchar_t* s, wchar_t c);

引数

s

対象のワイド文字列。

c

探すワイド文字。

戻り値

発見された場合は、s の中で、 c と一致した文字を指すポインタを返す。
発見できなかった場合は、ヌルポインタを返す。

詳細

ワイド文字列s の先頭から検索を行い、引数c と一致する最初の文字を探す。
ワイド文字列s の終端にあるヌル文字についても、検索対象に含まれる。

注意

検索対象のワイド文字列s は const であるのにも関わらず、戻り値は非const のポインタである。そのため、const指定されているワイド文字列を対象にした場合に、返されたポインタを経由して書き換えを行うことは未定義の動作である。

(C++ では、const指定の扱いが厳しくなっているため、この関数は const版と非const版にオーバーロードされている)。

使用例

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

int main(void)
{
    wchar_t* p = wcschr(L"abcdef", L'd');
    if (p == NULL) {
        puts("見つからない。");
    }
    else {
        wprintf(L"%ls\n", p);
    }
}

実行結果:

def

関連

ワイド文字列の末尾から逆方向に検索する wcsrchr関数がある。
ワイド文字列を探す場合は、wcsstr関数を使う。
また、ワイド文字列ではなく、メモリ上のバイト列を対象とした wmemchr関数がある。
マルチバイト文字版の strchr関数がある。

解説章


参考リンク


更新履歴

’2018/4/20 全体的に文章を見直し修正。
「NULL」という表記を「ヌルポインタ」に修正。

’2018/1/22 新規作成。



標準ライブラリのリファレンス(名前順)のトップページへ

標準ライブラリのリファレンス(ヘッダ別)のトップページへ

C言語編のトップページへ

Programming Place Plus のトップページへ



はてなブックマーク に保存 Pocket に保存 Facebook でシェア
X で ポストフォロー LINE で送る noteで書く
rss1.0 取得ボタン RSS 管理者情報 プライバシーポリシー
先頭へ戻る