CKTIS / C
wcsncmp — omezené porovnání širokých znaků
wcsncmp porovnává nejvýše n prvků wchar_t. Výsledek vyjadřuje pořadí nebo shodu porovnávané části, nikoli nutně celých řetězců.
Verze: C23; repository compiler flag, production runtime not attested
Syntaxe
#include <wchar.h>
int wcsncmp(const wchar_t *s1, const wchar_t *s2, size_t n);wcsncmp, deklarované v <wchar.h>, porovnává nejvýše n širokých znaků. Znaky za L'\0' se neporovnávají. První dvojice různých znaků v porovnávaném úseku určuje znaménko výsledku, jazyk C však nezaručuje, že implementace u této dvojice přestane číst. Limit se počítá v prvcích wchar_t, nikoli v bajtech.
Záporný, nulový nebo kladný výsledek znamená, že porovnávaná část prvního vstupu je oproti odpovídající části druhého vstupu menší, stejná nebo větší. Kontrolujte znaménko, nikoli přesné hodnoty -1 nebo 1. Pořadí se řídí hodnotami znaků, nikoli pravidly řazení podle locale.
Pro n == 0 je výsledek nulový; přesto předávejte platné ukazatele. Každé pole musí poskytovat alespoň n prvků nebo mezi dostupnými prvky obsahovat ukončovací znak L'\0'. U kratšího pole bez ukončovacího znaku nespoléhejte na rozdíl před koncem pole. Shodné předpony nedokazují shodu celých řetězců.
Pří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ýsledek
prefix_equal=1 whole_equal=0 zero_equal=1
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.