Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C

wcsncmp — ograniczone porównanie szerokich znaków

wcsncmp porównuje najwyżej n elementów wchar_t. Wynik określa porządek lub równość porównanej części, niekoniecznie całych napisów.

Wersja: C23; repository compiler flag, production runtime not attested

Składnia

#include <wchar.h>
int wcsncmp(const wchar_t *s1, const wchar_t *s2, size_t n);

wcsncmp z <wchar.h> porównuje najwyżej n szerokich znaków. Znaki po L'\0' nie są porównywane. Pierwsza para różnych znaków w porównywanym zakresie wyznacza znak wyniku, ale C nie gwarantuje, że implementacja przestanie odczytywać elementy po napotkaniu tej pary. Limit dotyczy elementów wchar_t, nie bajtów.

Wynik ujemny, zerowy lub dodatni oznacza odpowiednio mniejszą, równą lub większą porównaną część. Sprawdzaj znak, nie dokładną wartość -1 lub 1. Porządek wynika z wartości znaków, nie z reguł językowych locale.

Dla n == 0 wynik to zero; nadal przekazuj prawidłowe wskaźniki. Każda tablica musi udostępniać co najmniej n elementów albo zawierać terminator L'\0' wśród dostępnych elementów. Nie polegaj na wcześniejszej różnicy, gdy przekazujesz krótszą tablicę bez terminatora. Równe prefiksy nie dowodzą równości całych napisów.

Przykłady

#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;
}

Wynik

prefix_equal=1
whole_equal=0
zero_equal=1

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła