CKTIS / C
memchr — generické hledání bajtu C23
Generická funkce C23 `memchr(s, c, n)` z `<string.h>` najde mezi prvními `n` bajty objektu u `s` první bajt rovný `c` po převodu na `unsigned char`. Vrací ukazatel přesně na první shodu nebo null; implementace se musí chovat jako sekvenční čtení, které se při shodě okamžitě zastaví.
Verze: C23
Syntaxe
QVoid *memchr(QVoid *s, int c, size_t n);Generická funkce C23 memchr(s, c, n) z <string.h> najde mezi prvními n bajty objektu u s první bajt rovný c po převodu na unsigned char. Vrací ukazatel přesně na první shodu nebo null; implementace se musí chovat jako sekvenční čtení, které se při shodě okamžitě zastaví.
Příklad prohledá čtyřbajtové pole se dvěma bajty 0x42. Skutečné volání vrátí první výskyt, takže rozdíl ukazatelů a načtený bajt vytvoří 1 42, nikoli jen logickou hodnotu.
memchr nehledá ukončovací znak a může zkoumat binární data s nulovými bajty, ale n nesmí přesáhnout přístupný objekt; i při n == 0 C23 stále vyžaduje platnou hodnotu ukazatele. C23 zachová kvalifikaci const prohledávaného pole v typu výsledku a zde nepřijímá prvky volatile ani restrict; potlačení případného makra zpřístupní konkrétní externí funkci, ale toto použití je zastarávající.
Příklady
#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;}
Výsledek
1 42
Příklad prohledá čtyřbajtové pole se dvěma bajty `0x42`. Skutečné volání vrátí první výskyt, takže rozdíl ukazatelů a načtený bajt vytvoří `1 42`, nikoli jen logickou hodnotu.