CKTIS / C
wcsncmp — ограничено сравнение на широки знаци
wcsncmp сравнява най-много n елемента wchar_t. Резултатът описва подредбата или равенството на сравнената част, но не непременно на целите низове.
Версия: C23; repository compiler flag, production runtime not attested
Синтаксис
#include <wchar.h>
int wcsncmp(const wchar_t *s1, const wchar_t *s2, size_t n);wcsncmp, декларирана в <wchar.h>, сравнява най-много n широки знака. Знаците след L'\0' не се сравняват. Първата двойка различни знаци в сравняваната част определя знака на резултата, но C не гарантира, че реализацията ще спре да чете при тази двойка. Ограничението се отнася до броя на елементите wchar_t, а не до броя на байтовете.
Отрицателен, нулев или положителен резултат означава, че сравнената част е съответно по-малка, равна или по-голяма. Проверявайте знака, а не точните стойности -1 или 1. Подредбата зависи от стойностите на знаците, а не от правилата за езиково сортиране на локала.
При n == 0 резултатът е нула; въпреки това подавайте валидни указатели. Всеки масив трябва да предоставя поне n елемента или да съдържа завършващ знак L'\0' сред наличните си елементи. При по-къс масив без завършващ знак не разчитайте на разлика преди края на масива. Еднаквите префикси не доказват равенство на целите низове.
Примери
#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;
}Резултат
prefix_equal=1 whole_equal=0 zero_equal=1
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.