memchr

名前

memchr, memrchr, rawmemchr - 文字を探すためにメモリーをスキャンする

書式

#include <string.h>

void *memchr(const void *s, int c, size_t n);

void *memrchr(const void *s, int c, size_t n);

void *rawmemchr(const void *s, int c);

glibc 向けの機能検査マクロの要件 ( feature_test_macros(7) 参照):

memrchr(): rawmemchr(): _GNU_SOURCE

説明

memchr() 関数は、ポインター s が指し示すメモリー領域の先頭の n バイトから最初に登場する文字 c を探す。 c と s が指し示すメモリー領域の各バイトは両方とも unsigned char と解釈される。

memrchr() 関数は memchr() 関数に似ているが、先頭から順方向に探すのではなく、ポインター s が指し示す n バイトのメモリーブロックの末尾から逆向きに探す。

rawmemchr() 関数は memchr() と同様だが、 c が s が指す場所から始まるメモリー領域のどこかにあることを前提にして (つまり、プログラマはそのことを知っている)、最適化した方法で c の検索を実行する (すなわち、検索範囲の上限を示す引数も使用されない)。 c が見つからなかった場合、その結果はどうなるか分からない。次に示す呼び出しは、文字列終端のヌルバイトの位置を特定する高速な手段である。