CKTIS / C
memchr — búsqueda genérica de byte de C23
La función genérica de C23 `memchr(s, c, n)` de `<string.h>` localiza entre los primeros `n` bytes del objeto `s` el primer byte igual a `c` tras convertirlo a `unsigned char`. Devuelve un puntero exactamente a la primera coincidencia o null; la implementación debe comportarse como una lectura secuencial que se detiene al encontrarla.
Versión: C23
Sintaxis
QVoid *memchr(QVoid *s, int c, size_t n);La función genérica de C23 memchr(s, c, n) de <string.h> localiza entre los primeros n bytes del objeto s el primer byte igual a c tras convertirlo a unsigned char. Devuelve un puntero exactamente a la primera coincidencia o null; la implementación debe comportarse como una lectura secuencial que se detiene al encontrarla.
El ejemplo busca en un array de cuatro bytes que contiene dos bytes 0x42. La llamada real devuelve la primera aparición, por lo que la diferencia de punteros y el byte leído producen 1 42, no solo un booleano.
memchr no busca terminador y puede examinar datos binarios con bytes cero, pero n no debe superar el objeto accesible; incluso con n == 0, C23 sigue exigiendo un valor de puntero válido. C23 conserva la cualificación const del array buscado en el tipo del resultado y aquí no acepta elementos volatile ni restrict; suprimir un posible macro expone la función externa concreta, pero ese uso es obsolescente.
Ejemplos
#include <stddef.h>
#include <stdio.h>
#include <string.h>
int main(void){const unsigned char data[]={0x10,0x42,0x42,0x20};const unsigned char *hit=memchr(data,0x42,sizeof data);printf("%td %02X\n",hit-data,(unsigned)*hit);return 0;}
Resultado
1 42
El ejemplo busca en un array de cuatro bytes que contiene dos bytes `0x42`. La llamada real devuelve la primera aparición, por lo que la diferencia de punteros y el byte leído producen `1 42`, no solo un booleano.