WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C

strcspn — Länge eines Präfixes ohne angegebene Zeichen

strcspn gibt die Länge des Anfangsabschnitts einer Zeichenkette zurück, der keines der Zeichen aus einer zweiten Zeichenkette enthält. Gibt es einen Treffer, ist der size_t-Wert der Index des ersten Treffers; andernfalls ist er strlen(s1).

Version: C23; repository compiler flag, production runtime not attested

Syntax

#include <string.h>
size_t strcspn(const char *s1, const char *s2);

strcspn aus <string.h> gibt als size_t die Länge des längsten Präfixes von s1 zurück, das keine Zeichen aus s2 enthält. s2 legt eine Zeichenmenge fest, keine Teilzeichenkette. Keine der beiden Zeichenketten wird verändert.

Gibt es keinen Treffer, ist das Ergebnis strlen(s1); ein leeres s2 führt zum selben Ergebnis. Ein leeres s1 oder ein Treffer direkt am Anfang ergibt 0. Das abschließende \0 wird nicht mitgezählt.

Beide Argumente müssen auf gültige, mit \0 abgeschlossene Zeichenketten zeigen; NULL ist unzulässig. Das Ergebnis zählt Bytes, keine Unicode-Zeichen. Im Beispiel hat das Komma den Index 5.

Beispiele

#include <stdio.h>
#include <string.h>

int main(void)
{
    const char text[] = "alpha,beta;gamma";
    size_t n = strcspn(text, ",;");
    printf("%zu\n", n);
    return 0;
}

Ergebnis

5

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