strcspn

 

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>
size_t strcspn( const char *dest, const char *src );

Gibt die Länge des längsten Anfangssegments der nullterminierten Byte-Zeichenkette, auf die dest zeigt, zurück, das nur Zeichen enthält, die nicht in der nullterminierten Byte-Zeichenkette, auf die src zeigt, gefunden werden.

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

Parameter

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

Rückgabewert

Die Länge des längsten Anfangssegments, das nur Zeichen enthält, die nicht in der nullterminierten Byte-Zeichenkette, auf die src zeigt, gefunden werden.

Hinweise

Der Funktionsname steht für "komplementäres Segment" (complementary span), da die Funktion nach Zeichen sucht, die nicht in src gefunden werden, also dem Komplement von src.

Beispiel

Führen Sie diesen Code aus

#include <string.h>
#include <stdio.h>
 
int main(void)
{
    const char *string = "abcde312$#@";
    const char *invalid = "*$#";
 
    size_t valid_len = strcspn(string, invalid);
    if(valid_len != strlen(string))
       printf("'%s' contains invalid chars starting at position %zu\n",
               string, valid_len);
}

Ausgabe

'abcde312$#@' contains invalid chars starting at position 8

Referenzen

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

• 7.24.5.3 Die Funktion strcspn (S. 368)

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

• 7.21.5.3 Die Funktion strcspn (S. 331)

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

• 4.11.5.3 Die Funktion strcspn

Siehe auch

strspn	gibt die Länge des maximalen Anfangssegments zurück, das nur aus den Zeichen besteht, die in einem anderen Byte-String vorkommen (Funktion)
wcscspn (C95)	gibt die Länge des maximalen Anfangssegments zurück, das nur von den Wide-Zeichen, die *nicht* in einem anderen Wide-String gefunden werden (Funktion)
strpbrk	findet die erste Position eines beliebigen Zeichens aus einem String in einem anderen String (Funktion)
C++ Dokumentation für strcspn