Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje