memchr, wmemchr

 

Para obtener la documentación más reciente de Visual Studio 2017 RC, consulte Documentación de Visual Studio 2017 RC.

Buscar caracteres en un búfer.

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  

Parámetros

buf
Puntero al búfer.

c
Carácter que se va a buscar.

count
Número de caracteres que se va a comprobar.

Si se realiza correctamente, devuelve un puntero a la primera ubicación de c en buf. De lo contrario devuelve NULL.

memchry wmemchr buscar la primera aparición de c en la primera count bytes de buf. Se detiene cuando encuentra c o cuando ha comprobado la primera count bytes.

En C, estas funciones toman un puntero const como primer argumento. En C++, hay disponibles dos sobrecargas. La sobrecarga que toma un puntero a const devuelve un puntero a const; la versión que contiene un puntero a un valor que no es const devuelve un puntero a un valor que no es const. La macro _CONST_CORRECT_OVERLOADS se define si están disponibles tanto las versiones const como no const de estas funciones. Si necesitas no esconst comportamiento para ambos overloadsin C++ C++, defina el símbolo _CONST_RETURN.

RutinaEncabezado necesario
memchr<memory.h> o <string.h>
wmemchr<wchar.h>

Para obtener más información sobre la compatibilidad, vea Compatibilidad.

Todas las versiones de las bibliotecas en tiempo de ejecución de 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  

No es aplicable. Para llamar a la función estándar de C, use PInvoke. Para obtener más información, vea Ejemplos de invocación de plataforma.

Manipulación del búfer
_memccpy
memcmp, wmemcmp
memcpy, wmemcpy
memset, wmemset
strchr, wcschr, _mbschr, _mbschr_l

Mostrar: