CKTIS / C
memchr — generyczne wyszukiwanie bajtu C23
Generyczna funkcja C23 `memchr(s, c, n)` z `<string.h>` szuka pierwszego bajtu równego `c` po konwersji do `unsigned char` w pierwszych `n` bajtach obiektu `s`. Zwraca wskaźnik dokładnie do pierwszego trafienia albo null; implementacja ma zachowywać się jak odczyt sekwencyjny zatrzymany natychmiast po znalezieniu.
Wersja: C23
Składnia
QVoid *memchr(QVoid *s, int c, size_t n);Generyczna funkcja C23 memchr(s, c, n) z <string.h> szuka pierwszego bajtu równego c po konwersji do unsigned char w pierwszych n bajtach obiektu s. Zwraca wskaźnik dokładnie do pierwszego trafienia albo null; implementacja ma zachowywać się jak odczyt sekwencyjny zatrzymany natychmiast po znalezieniu.
Przykład przeszukuje czterobajtową tablicę zawierającą dwa bajty 0x42. Rzeczywiste wywołanie zwraca pierwsze wystąpienie, więc różnica wskaźników i odczyt bajtu dają 1 42, zamiast samej informacji prawda/fałsz.
memchr nie szuka znaku kończącego i może badać dane binarne z bajtami zero, lecz n nie może wykraczać poza dostępny obiekt; nawet przy n == 0 C23 nadal wymaga poprawnej wartości wskaźnika. C23 zachowuje kwalifikator const tablicy w typie wyniku, nie przyjmuje tu elementów volatile ani restrict; tłumienie ewentualnego makra udostępnia zewnętrzną funkcję o konkretnym typie, ale ten sposób jest obsolescent.
Przykłady
#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;}
Wynik
1 42
Przykład przeszukuje czterobajtową tablicę zawierającą dwa bajty `0x42`. Rzeczywiste wywołanie zwraca pierwsze wystąpienie, więc różnica wskaźników i odczyt bajtu dają `1 42`, zamiast samej informacji prawda/fałsz.