Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C

wcscmp — porównywanie łańcuchów szerokich

wcscmp porównuje łańcuchy wchar_t zakończone znakiem zerowym; znaczenie ma znak wyniku, nie jego dokładna wartość.

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

Składnia

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

wcscmp z <wchar.h> porównuje leksykograficznie dwa łańcuchy wchar_t, bez ich modyfikowania. Pierwsza różnica rozstrzyga kolejność według wartości wchar_t.

Wynik < 0, == 0 lub > 0 oznacza odpowiednio: pierwszy łańcuch jest mniejszy, równy lub większy. Nie zakładaj wartości -1 ani 1.

Oba wskaźniki muszą wskazywać czytelne łańcuchy zakończone L'\0'; NULL lub brak terminatora powoduje niezdefiniowane zachowanie. To nie sortowanie językowe: do porównania według LC_COLLATE służy wcscoll.

Przykłady

#include <stdio.h>
#include <wchar.h>

int main(void)
{
    printf("%d\n", wcscmp(L"cat", L"cat") == 0);
    printf("%d\n", wcscmp(L"2", L"3") != 0);
    return 0;
}

Wynik

1
1

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

Źródła