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++ 中,有两个重载可用。 采用指向 const 的指针的重载返回指向 const 的指针;采用指向非const 的版本的指针返回指向非const 的指针。 如果这些函数的 const 和非const 版本可用,则会定义宏 _CONST_CORRECT_OVERLOADS。 如果这两个 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" );
}
Output
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。有关更多信息,请参见平台调用示例。