CKTIS / C
wcsncmp — omejena primerjava širokih znakov
wcsncmp primerja največ n elementov wchar_t. Rezultat opisuje vrstni red ali enakost primerjanega dela, ne nujno celotnih nizov.
Različica: C23; repository compiler flag, production runtime not attested
Sintaksa
#include <wchar.h>
int wcsncmp(const wchar_t *s1, const wchar_t *s2, size_t n);wcsncmp, deklarirana v <wchar.h>, primerja največ n širokih znakov. Znaki za L'\0' se ne primerjajo. Prvi par različnih znakov v primerjavi določa predznak rezultata, vendar C ne zagotavlja, da bo implementacija pri tem paru prenehala brati. Omejitev je izražena v elementih wchar_t, ne v bajtih.
Negativen, ničeln ali pozitiven rezultat pomeni, da je primerjani del prvega niza manjši od ustreznega dela drugega niza, mu je enak ali je od njega večji. Preverite predznak, ne natančnih vrednosti -1 ali 1. Vrstni red določajo vrednosti znakov, ne pravila razvrščanja glede na krajevne nastavitve.
Pri n == 0 je rezultat nič; kljub temu podajte veljavne kazalce. Vsako polje mora imeti na voljo vsaj n elementov ali med razpoložljivimi elementi vsebovati zaključni znak L'\0'. Pri krajšem polju brez zaključnega znaka se ne zanašajte na razliko pred koncem polja. Enaki predponi ne dokazujeta enakosti celotnih nizov.
Primeri
#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;
}Rezultat
prefix_equal=1 whole_equal=0 zero_equal=1
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.