std::memchr

 

C++

言語

標準ライブラリヘッダ

フリースタンディング処理系とホスト処理系

名前付き要件

言語サポートライブラリ

コンセプトライブラリ (C++20)

診断ライブラリ

ユーティリティライブラリ

文字列ライブラリ

コンテナライブラリ

イテレータライブラリ

範囲ライブラリ (C++20)

アルゴリズムライブラリ

数値演算ライブラリ

ローカライゼーションライブラリ

入出力ライブラリ

ファイルシステムライブラリ (C++17)

正規表現ライブラリ (C++11)

アトミック操作ライブラリ (C++11)

スレッドサポートライブラリ (C++11)

技術仕様書

 

文字列ライブラリ

ヌル終端文字列

バイト文字列

マルチバイト文字列

ワイド文字列

クラス

basic_string

basic_string_view (C++17)

char_traits

 

ヌル終端バイト文字列

関数
文字操作
isalnum isalpha islower isupper isdigit isxdigit isblank (C++11)	iscntrl isgraph isspace isprint ispunct tolower toupper
数値形式への変換
atof atoiatolatoll (C++11) strtolstrtoll (C++11)	strtoulstrtoull (C++11) strtofstrtodstrtold (C++11)(C++11) strtoimaxstrtouimax (C++11)(C++11)
文字列操作
strcpy
strncpy
strcat
strncat
strxfrm
文字列検査
strlen strcmp strncmp strcoll strchr strrchr	strspn strcspn strpbrk strstr strtok
メモリ操作
memchr
memcmp
memset
memcpy
memmove
その他
strerror

 

ヘッダ <cstring> で定義
const void* memchr( const void* ptr, int ch, std::size_t count );
void* memchr(       void* ptr, int ch, std::size_t count );

ch を unsigned char に変換し、 ptr の指すオブジェクトの先頭 count 文字 (それぞれ unsigned char として解釈されます) からその値が最初に現れる位置を探します。

この関数は文字をシーケンシャルに読み込み、一致する文字が見つかると直ちに停止するかのように動作します。 ptr の指す配列が count より小さいけれども、配列内に一致が見つかる場合、動作は well-defined です。

(C++17以上)

引数

ptr	-	調べるオブジェクトを指すポインタ
ch	-	検索する文字
count	-	調べる最大文字数

戻り値

文字の位置を指すポインタ、またはそのような文字が見つからない場合は NULL。

例

文字の配列を検索します。

Run this code

#include <iostream>
#include <cstring>
 
int main()
{
    char arr[] = {'a','\0','a','A','a','a','A','a'};
    char *pc = (char*)std::memchr(arr,'A',sizeof arr);
    if (pc != NULL)
       std::cout << "search character found\n";
    else
       std::cout << "search character not found\n";
}

出力:

search character found

関連項目

strchr	文字が現れる最初の位置を探します (関数)
findfind_iffind_if_not (C++11)	一定の基準を満たす最初の要素を探します (関数テンプレート)
memchr の C言語リファレンス