KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C

wcslen — lengte van een wide-character-tekenreeks

wcslen uit <wchar.h> geeft het aantal wchar_t-elementen vóór het eerste nul-wide-character terug, zonder die afsluiter mee te tellen.

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

Syntax

#include <wchar.h>
size_t wcslen(const wchar_t *s);

wcslen(s) geeft de lengte van een wide-character-tekenreeks terug als size_t. De functie telt wchar_t-elementen, geen bytes of door mensen waargenomen tekens. De capaciteit van de array wordt niet gemeten.

s moet verwijzen naar een geldige, door nul afgesloten wide-character-tekenreeks. NULL doorgeven of de afsluiter weglaten binnen de toegankelijke array leidt tot ongedefinieerd gedrag; de functie accepteert geen leeslimiet.

In het voorbeeld bevat L"cat\0dog" een interne afsluiter, dus het resultaat is 3. De conversie %zu drukt een waarde van het type size_t af.

Voorbeelden

#include <stdio.h>
#include <wchar.h>

int main(void)
{
    const wchar_t text[] = L"cat\0dog";
    printf("%zu\n", wcslen(text));
    return 0;
}

Resultaat

3

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