memchr
, wmemchr
在緩衝區中尋找字元。
語法
void *memchr(
const void *buffer,
int c,
size_t count
); // C only
void *memchr(
void *buffer,
int c,
size_t count
); // C++ only
const void *memchr(
const void *buffer,
int c,
size_t count
); // C++ only
wchar_t *wmemchr(
const wchar_t * buffer,
wchar_t c,
size_t count
); // C only
wchar_t *wmemchr(
wchar_t * buffer,
wchar_t c,
size_t count
); // C++ only
const wchar_t *wmemchr(
const wchar_t * buffer,
wchar_t c,
size_t count
); // C++ only
參數
buffer
緩衝區的指標。
c
要尋找的字元。
count
要檢查的字元數。
傳回值
如果成功,則傳回 buffer
中 c
的第一個位置指標。 否則會傳回 NULL。
備註
memchr
並wmemchr
尋找 的第一個字元buffer
中count
出現的 c
。 它會在找到 c
或檢查第一 count
個字元時停止。
在 C 中,這些函式接受第一個引數的 const
指標。 在 C++ 中,可使用兩個多載。 接受 const
指標的多載會傳回 const
的指標,接受非 const
指標的版本會傳回非 const
的指標。 如果這些函式的 const
和 非const
版本都可用,則會定義巨集_CRT_CONST_CORRECT_OVERLOADS
。 如果您需要C++中兩個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
另請參閱
緩衝區操作
_memccpy
memcmp
, wmemcmp
memcpy
, wmemcpy
memset
, wmemset
strchr
、 、 wcschr
、 _mbschr
_mbschr_l