WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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.

Quellen