KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C

strcspn — lengte van een prefix zonder opgegeven tekens

strcspn geeft de lengte terug van het beginstuk van een tekenreeks dat geen van de tekens uit een tweede tekenreeks bevat. Als er een overeenkomst is, is het resultaat van het type size_t de index van de eerste overeenkomst; anders is het strlen(s1).

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

Syntax

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

strcspn uit <string.h> geeft als size_t de lengte terug van het langste prefix van s1 dat geen tekens uit s2 bevat. s2 geeft een verzameling tekens aan, geen deeltekenreeks. Geen van beide tekenreeksen wordt gewijzigd.

Als er geen overeenkomst is, is het resultaat strlen(s1); een lege s2 geeft hetzelfde resultaat. Een lege s1 of een overeenkomst meteen aan het begin geeft 0. De afsluitende \0 wordt niet meegeteld.

Beide argumenten moeten verwijzen naar geldige, met \0 afgesloten tekenreeksen; NULL is niet toegestaan. Het resultaat telt bytes, geen Unicode-tekens. In het voorbeeld heeft de komma index 5.

Voorbeelden

#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;
}

Resultaat

5

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen