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.