CKTIS / C
wcsncmp — ograničena usporedba širokih znakova
wcsncmp uspoređuje najviše n elemenata wchar_t. Rezultat opisuje poredak ili jednakost uspoređenog dijela, ne nužno cijelih nizova.
Verzija: 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, deklariran u <wchar.h>, uspoređuje najviše n širokih znakova. Znakovi nakon L'\0' ne uspoređuju se. Prvi par različitih znakova u usporedbi određuje predznak rezultata, ali C ne jamči da će implementacija prestati čitati kod tog para. Ograničenje se odnosi na broj elemenata wchar_t, a ne na broj bajtova.
Negativan, nulti ili pozitivan rezultat znači da je uspoređeni dio redom manji, jednak ili veći. Provjeravajte predznak, a ne točne vrijednosti -1 ili 1. Poredak ovisi o vrijednostima znakova, a ne o pravilima razvrstavanja jezika u lokalnim postavkama.
Za n == 0 rezultat je nula; ipak proslijedite valjane pokazivače. Svako polje mora imati barem n dostupnih elemenata ili među dostupnim elementima sadržavati završni znak L'\0'. Kod kraćeg polja bez završnog znaka nemojte se oslanjati na razliku prije kraja polja. Jednaki prefiksi ne dokazuju jednakost cijelih nizova.
Primjeri
#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
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.