KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C

wcsncmp — begrensde vergelijking van brede tekens

wcsncmp vergelijkt maximaal n wchar_t-elementen. Het resultaat beschrijft de volgorde of gelijkheid van het vergeleken deel, niet noodzakelijk van volledige tekenreeksen.

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

Syntax

#include <wchar.h>
int wcsncmp(const wchar_t *s1, const wchar_t *s2, size_t n);

wcsncmp, gedeclareerd in <wchar.h>, vergelijkt maximaal n brede tekens. Tekens na L'\0' worden niet vergeleken. Het eerste paar verschillende tekens in de vergelijking bepaalt het teken van het resultaat, maar C garandeert niet dat de implementatie bij dat paar stopt met lezen. De limiet telt wchar_t-elementen, geen bytes.

Een negatief, nul of positief resultaat betekent dat het vergeleken deel respectievelijk kleiner, gelijk of groter is. Controleer het teken, niet de exacte waarden -1 of 1. De volgorde volgt uit de tekenwaarden, niet uit de sorteervolgorde van de locale.

Bij n == 0 is het resultaat nul; geef toch geldige pointers door. Elke array moet minstens n elementen beschikbaar stellen of binnen de beschikbare elementen een afsluitend L'\0' bevatten. Vertrouw bij een kortere array zonder afsluitteken niet op een verschil vóór het einde van de array. Gelijke voorvoegsels bewijzen niet dat de volledige tekenreeksen gelijk zijn.

Voorbeelden

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

int main(void)
{
    const wchar_t a[] = L"cat";
    const wchar_t b[] = L"car";

    printf("prefix_equal=%d\n", wcsncmp(a, b, 2) == 0);
    printf("whole_equal=%d\n", wcsncmp(a, b, 3) == 0);
    printf("zero_equal=%d\n", wcsncmp(a, b, 0) == 0);
    return 0;
}

Resultaat

prefix_equal=1
whole_equal=0
zero_equal=1

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