strchr

 

C

Compiler-Unterstützung

Sprache

Header

Typunterstützung

Programm-Dienstprogramme

Unterstützung für variable Funktionsargumente

Fehlerbehandlung

Dynamische Speicherverwaltung

Bibliothek für Zeichenketten

Algorithmen

Numerik

Datums- und Zeitdienstprogramme

Ein-/Ausgabeunterstützung

Lokalisierungsunterstützung

Unterstützung für Nebenläufigkeit (C11)

Technische Spezifikationen

Symbolindex

 

Bibliothek für Zeichenketten

Null-terminierte Byte-Strings

Null-terminierte Multibyte-Strings

Null-terminierte breite Zeichenketten

 

Null-terminierte Byte-Strings

Funktionen
Zeichenmanipulation
isalnum isalpha islower isupper isdigit isxdigit isblank (C99)	iscntrl isgraph isspace isprint ispunct tolower toupper
Konvertierungen zu und von numerischen Formaten
atoiatolatoll (C99) atof strtolstrtoll (C99) strtoulstrtoull (C99)	strtoimaxstrtouimax (C99)(C99) strtofstrtodstrtold (C99)(C99) strfromfstrfromdstrfroml (C23)(C23)(C23)
Stringmanipulation
strcpystrcpy_s (C11) strncpystrncpy_s (C11) strcatstrcat_s (C11)	strncatstrncat_s (C11) strxfrm strdup (C23) strndup (C23)
Stringuntersuchung
strlenstrnlen_s (C11) strcmp strncmp strcoll strchr strrchr	strspn strcspn strpbrk strstr strtokstrtok_s (C11)
Speichermanipulation
memchr memcmp memsetmemset_explicitmemset_s (C23)(C11)	memcpymemcpy_s (C11) memmovememmove_s (C11) memccpy (C23)
Sonstiges
strerrorstrerror_sstrerrorlen_s (C11)(C11)

 

Definiert in Header <string.h>
char* strchr( const char* str, int ch );	(1)
/*QChar*/ *strchr( /*QChar*/ *str, int ch );	(2)	(seit C23)

1) Findet das erste Vorkommen von ch (nach Konvertierung in char, als ob durch (char)ch) im null-terminierten Byte-String, auf den str zeigt (jedes Zeichen wird als unsigned char interpretiert). Das abschließende Nullzeichen gilt als Teil des Strings und kann gefunden werden, wenn nach '\0' gesucht wird.

2) Typ-generische Funktion, äquivalent zu (1). Sei T ein nicht-qualifizierter Zeichentyp.

• Wenn str vom Typ const T* ist, ist der Rückgabetyp const char*.
• Andernfalls, wenn str vom Typ T* ist, ist der Rückgabetyp char*.
• Andernfalls ist das Verhalten undefiniert.

Wenn eine Makrodefinition jeder dieser generischen Funktionen unterdrückt wird, um auf eine tatsächliche Funktion zuzugreifen (z. B. wenn (strchr) oder ein Funktionszeiger verwendet wird), wird die tatsächliche Funktionsdeklaration (1) sichtbar.

Das Verhalten ist undefiniert, wenn str kein Zeiger auf einen null-terminierten Byte-String ist.

Parameter

str	-	Zeiger auf den nullterminierten Byte-String, der analysiert werden soll
ch	-	Zu durchsuchendes Zeichen

Rückgabewert

Zeiger auf das gefundene Zeichen in str, oder Nullzeiger, wenn kein solches Zeichen gefunden wurde.

Beispiel

Führen Sie diesen Code aus

#include <stdio.h>
#include <string.h>
 
int main(void)
{
    const char *str = "Try not. Do, or do not. There is no try.";
    char target = 'T';
    const char* result = str;
 
    while((result = strchr(result, target)) != NULL)
    {
        printf("Found '%c' starting at '%s'\n", target, result);
        ++result; // Increment result, otherwise we'll find target at the same location
    }
}

Ausgabe

Found 'T' starting at 'Try not. Do, or do not. There is no try.'
Found 'T' starting at 'There is no try.'

Referenzen

• C23-Standard (ISO/IEC 9899:2024)

• 7.24.5.2 Die strchr-Funktion (p: TBD)

• C17-Standard (ISO/IEC 9899:2018)

• 7.24.5.2 Die strchr-Funktion (p: TBD)

• C11-Standard (ISO/IEC 9899:2011)

• 7.24.5.2 Die strchr-Funktion (p: 367-368)

• C99-Standard (ISO/IEC 9899:1999)

• 7.21.5.2 Die strchr-Funktion (p: 330)

• C89/C90-Standard (ISO/IEC 9899:1990)

• 4.11.5.2 Die strchr-Funktion

Siehe auch

memchr	durchsucht ein Array nach dem ersten Vorkommen eines Zeichens (Funktion)
strrchr	findet das letzte Vorkommen eines Zeichens (Funktion)
strpbrk	findet die erste Position eines beliebigen Zeichens aus einem String in einem anderen String (Funktion)
C++ Dokumentation für strchr