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.