WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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.

Quellen