memchr、wmemchr
バッファーの検索文字列。
void *memchr(
const void *buf,
int c,
size_t count
); // C only
void *memchr(
void *buf,
int c,
size_t count
); // C++ only
const void *memchr(
const void *buf,
int c,
size_t count
); // C++ only
wchar_t *wmemchr(
const wchar_t * buf,
wchar_t c,
size_t count
); // C only
wchar_t *wmemchr(
wchar_t * buf,
wchar_t c,
size_t count
); // C++ only
const wchar_t *wmemchr(
const wchar_t * buf,
wchar_t c,
size_t count
); // C++ only
パラメーター
buf
バッファーへのポインター。c
検索する文字。count
チェックする文字数。
戻り値
buf の c の先頭へのポインターを返す成功します。それ以外の場合は NULL を返します。
解説
memchr と wmemchr は buf の count の最初のバイトの c の最初の出現箇所を検索します。これは c が見つからない場合は count の先頭バイトをチェックする場合は停止します。
C では、これらの関数は、最初の引数に const ポインターを受け取ります。C++ では、2 つのオーバーロードを使用できます。const へのポインターを受け取るオーバーロードでは、const へのポインターが返されます。非 const へのポインターを受け取るバージョンでは、非 const へのポインターが返されます。この関数の const と非 const の両方のバージョンが使用できる場合、_CONST_CORRECT_OVERLOADS というマクロが定義されます。両方の C++ overloadsin C++ の場合 const のない動作が必要な場合はシンボル _CONST_RETURN を定義します。
必要条件
ルーチン |
必須ヘッダー |
---|---|
memchr |
<memory.h> または <string.h> |
wmemchr |
<wchar.h> |
互換性の詳細については、「互換性」を参照してください。
ライブラリ
C ランタイム ライブラリのすべてのバージョン。
使用例
// crt_memchr.c
#include <memory.h>
#include <stdio.h>
int ch = 'r';
char str[] = "lazy";
char string[] = "The quick brown dog jumps over the lazy fox";
char fmt1[] = " 1 2 3 4 5";
char fmt2[] = "12345678901234567890123456789012345678901234567890";
int main( void )
{
char *pdest;
int result;
printf( "String to be searched:\n %s\n", string );
printf( " %s\n %s\n\n", fmt1, fmt2 );
printf( "Search char: %c\n", ch );
pdest = memchr( string, ch, sizeof( string ) );
result = (int)(pdest - string + 1);
if ( pdest != NULL )
printf( "Result: %c found at position %d\n", ch, result );
else
printf( "Result: %c not found\n" );
}
出力
String to be searched:
The quick brown dog jumps over the lazy fox
1 2 3 4 5
12345678901234567890123456789012345678901234567890
Search char: r
Result: r found at position 12
同等の .NET Framework 関数
該当なし標準 C 関数を呼び出すには、PInvoke を使用します。詳細については、「プラットフォーム呼び出しの例」を参照してください。