Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C

memchr — ricerca generica di byte C23

La funzione generica C23 `memchr(s, c, n)` di `<string.h>` individua tra i primi `n` byte dell’oggetto `s` il primo byte uguale a `c` dopo la conversione a `unsigned char`. Restituisce un puntatore esattamente alla prima corrispondenza oppure null; l’implementazione deve comportarsi come una lettura sequenziale che si ferma subito alla corrispondenza.

Versione: C23

Sintassi

QVoid *memchr(QVoid *s, int c, size_t n);

La funzione generica C23 memchr(s, c, n) di <string.h> individua tra i primi n byte dell’oggetto s il primo byte uguale a c dopo la conversione a unsigned char. Restituisce un puntatore esattamente alla prima corrispondenza oppure null; l’implementazione deve comportarsi come una lettura sequenziale che si ferma subito alla corrispondenza.

L’esempio cerca in un array di quattro byte che contiene due byte 0x42. La chiamata reale restituisce la prima occorrenza, quindi la differenza tra puntatori e il byte letto producono 1 42, non un semplice booleano.

memchr non cerca un terminatore e può esaminare dati binari con byte zero, ma n non deve oltrepassare l’oggetto accessibile; anche con n == 0, C23 richiede comunque un valore di puntatore valido. C23 conserva la qualificazione const dell’array nel tipo del risultato e qui non accetta elementi volatile o restrict; sopprimere un possibile macro espone la funzione esterna concreta, ma tale uso è obsolescente.

Esempi

#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;}

Risultato

1 42

L’esempio cerca in un array di quattro byte che contiene due byte `0x42`. La chiamata reale restituisce la prima occorrenza, quindi la differenza tra puntatori e il byte letto producono `1 42`, non un semplice booleano.

Fonti