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.