CKTIS / C
memchr — generické hľadanie bajtu C23
Generická funkcia C23 `memchr(s, c, n)` z `<string.h>` nájde medzi prvými `n` bajtmi objektu pri `s` prvý bajt rovný `c` po prevode na `unsigned char`. Vracia ukazovateľ presne na prvú zhodu alebo null; implementácia sa musí správať ako sekvenčné čítanie, ktoré sa pri zhode okamžite zastaví.
Verzia: C23
Syntax
QVoid *memchr(QVoid *s, int c, size_t n);Generická funkcia C23 memchr(s, c, n) z <string.h> nájde medzi prvými n bajtmi objektu pri s prvý bajt rovný c po prevode na unsigned char. Vracia ukazovateľ presne na prvú zhodu alebo null; implementácia sa musí správať ako sekvenčné čítanie, ktoré sa pri zhode okamžite zastaví.
Príklad prehľadá štvorbajtové pole s dvoma bajtmi 0x42. Skutočné volanie vráti prvý výskyt, takže rozdiel ukazovateľov a načítaný bajt vytvoria 1 42, nie iba logickú hodnotu.
memchr nehľadá ukončovací znak a môže skúmať binárne dáta s nulovými bajtmi, ale n nesmie presiahnuť prístupný objekt; aj pri n == 0 C23 stále vyžaduje platnú hodnotu ukazovateľa. C23 zachová kvalifikáciu const prehľadávaného poľa v type výsledku a tu neprijíma prvky volatile ani restrict; potlačenie prípadného makra sprístupní konkrétnu externú funkciu, ale toto použitie je zastarávajúce.
Prí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ýsledok
1 42
Príklad prehľadá štvorbajtové pole s dvoma bajtmi `0x42`. Skutočné volanie vráti prvý výskyt, takže rozdiel ukazovateľov a načítaný bajt vytvoria `1 42`, nie iba logickú hodnotu.