CKTIS / C
memchr — generično iskanje bajta C23
Generična funkcija C23 `memchr(s, c, n)` iz `<string.h>` med prvimi `n` bajti objekta pri `s` najde prvi bajt, enak `c` po pretvorbi v `unsigned char`. Vrne kazalec natančno na prvo ujemanje ali null; izvedba se mora obnašati kot zaporedno branje, ki se ob ujemanju takoj ustavi.
Različica: C23
Sintaksa
QVoid *memchr(QVoid *s, int c, size_t n);Generična funkcija C23 memchr(s, c, n) iz <string.h> med prvimi n bajti objekta pri s najde prvi bajt, enak c po pretvorbi v unsigned char. Vrne kazalec natančno na prvo ujemanje ali null; izvedba se mora obnašati kot zaporedno branje, ki se ob ujemanju takoj ustavi.
Primer preišče štiribajtno tabelo z dvema bajtoma 0x42. Dejanski klic vrne prvi pojav, zato razlika kazalcev in prebrani bajt ustvarita 1 42, ne le logične vrednosti.
memchr ne išče zaključnega znaka in lahko pregleduje binarne podatke z ničelnimi bajti, vendar n ne sme preseči dostopnega objekta; tudi pri n == 0 C23 še vedno zahteva veljavno vrednost kazalca. C23 ohrani kvalifikacijo const preiskane tabele v tipu rezultata in tu ne sprejema elementov volatile ali restrict; zatiranje morebitnega makra razkrije konkretno zunanjo funkcijo, vendar je taka raba zastarevajoča.
Primeri
#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
Primer preišče štiribajtno tabelo z dvema bajtoma `0x42`. Dejanski klic vrne prvi pojav, zato razlika kazalcev in prebrani bajt ustvarita `1 42`, ne le logične vrednosti.