Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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.

Viri