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.