strpbrk

 

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 *strpbrk( const char *dest, const char *breakset );	(1)
/*QChar*/ *strpbrk( /*QChar*/ *dest, const char *breakset );	(2)	(seit C23)

1 ) Sucht in der nullterminierten Byte-Zeichenkette, auf die dest zeigt, nach einem beliebigen Zeichen aus der nullterminierten Byte-Zeichenkette, auf die breakset zeigt, und gibt einen Zeiger auf dieses Zeichen zurück.

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

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

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

Das Verhalten ist undefiniert, wenn dest oder breakset kein Zeiger auf eine nullterminierte Byte-Zeichenkette ist.

Parameter

dest	-	Zeiger auf den nullterminierten Byte-String, der analysiert werden soll
breakset	-	Zeiger auf die nullterminierte Byte-Zeichenkette, die die zu suchenden Zeichen enthält

Rückgabewert

Zeiger auf das erste Zeichen in dest, das sich auch in breakset befindet, oder ein Nullzeiger, wenn kein solches Zeichen existiert.

Hinweise

Der Name steht für "string pointer break" (Zeichenkettenzeiger-Unterbrechung), da er einen Zeiger auf das erste der Trennzeichen ("break") zurückgibt.

Beispiel

Führen Sie diesen Code aus

#include <stdio.h>
#include <string.h>
 
int main(void)
{
    const char* str = "hello world, friend of mine!";
    const char* sep = " ,!";
 
    unsigned int cnt = 0;
    do
    {
       str = strpbrk(str, sep); // find separator
       if(str) str += strspn(str, sep); // skip separator
       ++cnt; // increment word count
    }
    while(str && *str);
 
    printf("There are %u words\n", cnt);
}

Ausgabe

There are 5 words

Referenzen

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

• 7.24.5.4 Die Funktion strpbrk (p: TBD)

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

• 7.24.5.4 Die Funktion strpbrk (p: TBD)

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

• 7.24.5.4 Die Funktion strpbrk (p: 368)

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

• 7.21.5.4 Die Funktion strpbrk (p: 331)

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

• 4.11.5.4 Die Funktion strpbrk

Siehe auch

strcspn	gibt die Länge des maximalen Anfangssegments zurück, das nur aus den Zeichen besteht, die in einem anderen Byte-String nicht vorkommen (Funktion)
strchr	findet das erste Vorkommen eines Zeichens (Funktion)
strtokstrtok_s (C11)	findet das nächste Token in einem Byte-String (Funktion)
C++ Dokumentation für strpbrk