CKTIS / C
strchr — erstes Vorkommen eines Zeichens
strchr sucht in einer C-Zeichenkette nach dem ersten Vorkommen eines Zeichens und gibt einen Zeiger darauf oder NULL zurück.
Version: C23; repository compiler flag, production runtime not attested
Syntax
#include <string.h>
QChar *strchr(QChar *s, int c);strchr aus <string.h> sucht das erste Zeichen, das mit c nach dessen Umwandlung in char übereinstimmt. Die Funktion gibt einen Zeiger auf dieses Zeichen oder NULL zurück. Die Suche nach \0 findet das abschließende Nullzeichen.
In C23 steht QChar hier für char oder const char. Es ist kein Typ, den man deklarieren soll. Der generische Aufruf erhält const: Für const char * ist das Ergebnis const char *.
s muss auf eine gültige, mit einem Nullzeichen abgeschlossene Zeichenkette zeigen; NULL ist nicht zulässig. Prüfe das Ergebnis vor dem Dereferenzieren. Das Beispiel gibt einen bei null beginnenden Index und das Ergebnis einer erfolglosen Suche aus.
Beispiele
#include <stdio.h>
#include <string.h>
int main(void)
{
const char text[] = "banana";
const char *p = strchr(text, 'a');
if (p != NULL) {
printf("%td\n", p - text);
}
puts(strchr(text, 'z') == NULL ? "missing" : "found");
return 0;
}Ergebnis
1 missing
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.