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`, а не само логическа стойност.