CKTIS / C
memchr — generische C23-Bytesuche
Die generische C23-Funktion `memchr(s, c, n)` aus `<string.h>` findet unter den ersten `n` Bytes des Objekts bei `s` das erste Byte, das nach Umwandlung von `c` in `unsigned char` gleich ist. Sie liefert einen Zeiger genau auf den ersten Treffer oder null; die Implementierung muss sich wie ein sequenzieller, beim Treffer sofort endender Lesevorgang verhalten.
Version: C23
Syntax
QVoid *memchr(QVoid *s, int c, size_t n);Die generische C23-Funktion memchr(s, c, n) aus <string.h> findet unter den ersten n Bytes des Objekts bei s das erste Byte, das nach Umwandlung von c in unsigned char gleich ist. Sie liefert einen Zeiger genau auf den ersten Treffer oder null; die Implementierung muss sich wie ein sequenzieller, beim Treffer sofort endender Lesevorgang verhalten.
Das Beispiel durchsucht ein Vier-Byte-Array mit zwei Bytes 0x42. Der echte Aufruf liefert das erste Vorkommen, sodass Zeigerdifferenz und Bytewert 1 42 ergeben und nicht nur einen Wahrheitswert.
memchr sucht keinen Terminator und kann Binärdaten mit Nullbytes untersuchen, doch n darf nicht über das zugängliche Objekt hinausreichen; selbst bei n == 0 verlangt C23 einen gültigen Zeigerwert. C23 erhält die const-Qualifikation des durchsuchten Arrays im Ergebnistyp und akzeptiert hier keine volatile- oder restrict-Elementqualifikation; Unterdrücken eines möglichen Makros legt die konkrete externe Funktion frei, ist aber obsolescent.
Beispiele
#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;}
Ergebnis
1 42
Das Beispiel durchsucht ein Vier-Byte-Array mit zwei Bytes `0x42`. Der echte Aufruf liefert das erste Vorkommen, sodass Zeigerdifferenz und Bytewert `1 42` ergeben und nicht nur einen Wahrheitswert.