Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C

wcsncmp — confronto limitato di caratteri wide

wcsncmp confronta al massimo n elementi wchar_t. Il risultato indica l’ordine o l’uguaglianza della parte confrontata, non necessariamente delle stringhe intere.

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

Sintassi

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

wcsncmp, dichiarata in <wchar.h>, confronta al massimo n caratteri wide. I caratteri successivi a L'\0' non vengono confrontati. La prima coppia di caratteri diversi nel confronto determina il segno del risultato, ma il C non garantisce che l’implementazione smetta di leggere a quel punto. Il limite conta gli elementi wchar_t, non i byte.

Un risultato negativo, zero o positivo indica che la parte confrontata è rispettivamente minore, uguale o maggiore. Verifica il segno, non i valori esatti -1 o 1. L’ordine dipende dai valori dei caratteri, non dalle regole di collazione della locale.

Per n == 0, il risultato è zero; passa comunque puntatori validi. Ogni array deve fornire almeno n elementi oppure contenere un terminatore L'\0' tra gli elementi disponibili. Non fare affidamento su una differenza che si manifesta prima della fine di un array più corto e privo di terminatore. Prefissi uguali non dimostrano che le stringhe intere siano uguali.

Esempi

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

Risultato

prefix_equal=1
whole_equal=0
zero_equal=1

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti