База знанияИзпитен център
BGБългарски
Избери език13

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

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници