База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / C

memchr — генерично търсене на байт в C23

Генеричната функция на C23 `memchr(s, c, n)` от `<string.h>` намира сред първите `n` байта на обекта при `s` първия байт, равен на `c` след преобразуване до `unsigned char`. Връща указател точно към първото съвпадение или null; реализацията трябва да се държи като последователно четене, което спира веднага при съвпадение.

Версия: C23

Синтаксис

QVoid *memchr(QVoid *s, int c, size_t n);

Генеричната функция на C23 memchr(s, c, n) от <string.h> намира сред първите n байта на обекта при s първия байт, равен на c след преобразуване до unsigned char. Връща указател точно към първото съвпадение или null; реализацията трябва да се държи като последователно четене, което спира веднага при съвпадение.

Примерът претърсва масив от четири байта с два байта 0x42. Реалното извикване връща първото срещане, затова разликата на указателите и прочетеният байт дават 1 42, а не само логическа стойност.

memchr не търси завършващ знак и може да преглежда двоични данни с нулеви байтове, но n не трябва да излиза извън достъпния обект; дори при n == 0 C23 още изисква валидна стойност на указателя. C23 запазва квалификатора const на претърсвания масив в типа на резултата и тук не приема елементи volatile или restrict; потискането на евентуален macro показва конкретната външна функция, но тази употреба е остаряваща.

Примери

#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;}

Резултат

1 42

Примерът претърсва масив от четири байта с два байта `0x42`. Реалното извикване връща първото срещане, затова разликата на указателите и прочетеният байт дават `1 42`, а не само логическа стойност.

Източници