Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / C

memchr — recherche générique d’octet C23

La fonction générique C23 `memchr(s, c, n)` de `<string.h>` repère, parmi les `n` premiers octets de l’objet `s`, le premier octet égal à `c` après conversion en `unsigned char`. Elle renvoie un pointeur exactement sur la première occurrence ou null ; l’implémentation doit se comporter comme une lecture séquentielle arrêtée dès la correspondance.

Version : C23

Syntaxe

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

La fonction générique C23 memchr(s, c, n) de <string.h> repère, parmi les n premiers octets de l’objet s, le premier octet égal à c après conversion en unsigned char. Elle renvoie un pointeur exactement sur la première occurrence ou null ; l’implémentation doit se comporter comme une lecture séquentielle arrêtée dès la correspondance.

L’exemple parcourt un tableau de quatre octets contenant deux fois 0x42. L’appel réel renvoie la première occurrence : la différence de pointeurs et l’octet lu produisent 1 42, et non un simple booléen.

memchr ne cherche aucun terminateur et accepte des données binaires contenant des octets nuls, mais n ne doit pas dépasser l’objet accessible ; même avec n == 0, C23 exige encore une valeur de pointeur valide. C23 conserve la qualification const du tableau dans le type du résultat et n’accepte pas ici des éléments volatile ou restrict ; supprimer un éventuel macro expose la fonction externe concrète, mais cet usage est obsolescent.

Exemples

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

Résultat

1 42

L’exemple parcourt un tableau de quatre octets contenant deux fois `0x42`. L’appel réel renvoie la première occurrence : la différence de pointeurs et l’octet lu produisent `1 42`, et non un simple booléen.

Sources