Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / C

wcsncmp — obmedzené porovnanie širokých znakov

wcsncmp porovnáva najviac n prvkov wchar_t. Výsledok vyjadruje poradie alebo zhodu porovnanej časti, nie nevyhnutne celých reťazcov.

Verzia: 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, deklarované v <wchar.h>, porovnáva najviac n širokých znakov. Znaky za L'\0' sa neporovnávajú. Prvá dvojica rôznych znakov v porovnávanom úseku určuje znamienko výsledku, jazyk C však nezaručuje, že implementácia pri tejto dvojici prestane čítať. Limit sa počíta v prvkoch wchar_t, nie v bajtoch.

Záporný, nulový alebo kladný výsledok znamená, že porovnávaná časť prvého vstupu je oproti zodpovedajúcej časti druhého vstupu menšia, rovnaká alebo väčšia. Kontrolujte znamienko, nie presné hodnoty -1 alebo 1. Poradie sa riadi hodnotami znakov, nie pravidlami radenia podľa locale.

Pre n == 0 je výsledok nula; napriek tomu odovzdajte platné ukazovatele. Každé pole musí poskytovať aspoň n prvkov alebo medzi dostupnými prvkami obsahovať ukončovací znak L'\0'. Pri kratšom poli bez ukončovacieho znaku sa nespoliehajte na rozdiel pred koncom poľa. Rovnaké predpony nedokazujú zhodu celých reťazcov.

Príklady

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

Výsledok

prefix_equal=1
whole_equal=0
zero_equal=1

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje