Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła