CKTIS / C
memchr — generičko traženje bajta C23
Generička funkcija C23 `memchr(s, c, n)` iz `<string.h>` među prvih `n` bajtova objekta pri `s` nalazi prvi bajt jednak `c` nakon pretvorbe u `unsigned char`. Vraća pokazivač točno na prvo podudaranje ili null; implementacija se mora ponašati kao sekvencijalno čitanje koje odmah staje pri podudaranju.
Verzija: C23
Sintaksa
QVoid *memchr(QVoid *s, int c, size_t n);Generička funkcija C23 memchr(s, c, n) iz <string.h> među prvih n bajtova objekta pri s nalazi prvi bajt jednak c nakon pretvorbe u unsigned char. Vraća pokazivač točno na prvo podudaranje ili null; implementacija se mora ponašati kao sekvencijalno čitanje koje odmah staje pri podudaranju.
Primjer pretražuje polje od četiri bajta s dva bajta 0x42. Stvarni poziv vraća prvu pojavu, pa razlika pokazivača i pročitani bajt daju 1 42, a ne samo logičku vrijednost.
memchr ne traži završni znak i može pregledavati binarne podatke s nultim bajtovima, ali n ne smije prijeći dostupan objekt; čak i uz n == 0, C23 i dalje zahtijeva valjanu vrijednost pokazivača. C23 čuva kvalifikaciju const pretraživanog polja u tipu rezultata i ovdje ne prihvaća elemente volatile ni restrict; potiskivanje mogućeg makra otkriva konkretnu vanjsku funkciju, ali ta je uporaba zastarijevajuća.
Primjeri
#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;}
Rezultat
1 42
Primjer pretražuje polje od četiri bajta s dva bajta `0x42`. Stvarni poziv vraća prvu pojavu, pa razlika pokazivača i pročitani bajt daju `1 42`, a ne samo logičku vrijednost.