strcspn, _mbscspn, wcscspn

Nach oben zu string.h - Index

Header-Datei

string.h, wchar.h, mbstring.h

Kategorie

Routinen für Speicher- und String-Bearbeitung

Prototyp

size_t strcspn(const char *s1, const char *s2);

size_t wcscspn(const wchar_t *s1, const wchar_t *s2);

size_t _mbscspn(const unsigned char *s1, const unsigned char *s2);

Beschreibung

Durchsucht einen String nach dem ersten Segment, das keines der Zeichen der angegebenen Zeichenmenge enthält.

Die strcspn-Funktionen lesen in s1 Zeichen für Zeichen, bis eines der in s2 enthaltenen Zeichen gefunden wird. Zurückgegeben wird die Anzahl der Zeichen, die in s1 gelesen werden konnten. Das terminierende Nullzeichen wird nicht gezählt. Die Funktionen ändern keinen der Strings.

Rückgabewert

strcspn gibt die Länge der ersten Zeichensequenz von s1 zurück, die keines der im String s2 enthaltenen Zeichen aufweist.

Beispiel

 #include <stdio.h>
 #include <string.h>
 #include <alloc.h>
 int main(void)
 {
    char *string1 = "1234567890";
    char *string2 = "747DC8";
    int length;
    length = strcspn(string1, string2);
    printf("Character where strings intersect is at position %d\n",
           length);
    return 0;
 }

Portabilität

	POSIX	Win32	ANSI C	ANSI C++
strcspn	+	+	+	+
_mbscspn		+
wcscspn		+	+	+