_mbsnbicmp, _mbsnbicmp_l

Articolo
06/09/2015

Confronta n byte di due stringhe di caratteri multibyte ignorando la distinzione tra maiuscole e minuscole.

Importante

Non è possibile usare questa API nelle applicazioni eseguite in Windows Runtime.Per altre informazioni, vedere l'argomento relativo alle funzioni CRT non supportate con /ZW.

int _mbsnbicmp(    const unsigned char *string1,    const unsigned char *string2,    size_t count  );

Parametri

string1, string2
Stringhe che terminano con Null da confrontare.
count
Numero di byte da confrontare.

Valore restituito

Il valore restituito indica la relazione ordinale tra le sottostringhe.

Valore restituito	Descrizione
< 0	La sottostringa di string1 è minore della sottostringa di string2.
0	La sottostringa di string1 è identica alla sottostringa di string2.
> 0	La sottostringa di string1 è maggiore della sottostringa di string2.

In caso di errore, _mbsnbcmp restituisce _NLSCMPERROR, definito in String.h e Mbstring.h.

Note

La funzione _mbsnbicmp esegue un confronto ordinale al massimo dei primi count byte di string1 e string2. Il confronto viene eseguito convertendo ogni carattere in minuscolo; _mbsnbcmp è una versione di _mbsnbicmp che effettua la distinzione tra maiuscole e minuscole. Il confronto termina se viene raggiunto un carattere di terminazione Null in entrambe le stringhe prima che vengano confrontati count caratteri. Se le stringhe sono uguali quando viene raggiunto un carattere di terminazione Null in entrambe le stringhe prima che vengano confrontati count caratteri, la stringa più corta sarà la minore.

_mbsnbicmp è simile a _mbsnicmp, ad eccezione del fatto che confronta le stringhe fino a count byte anziché per caratteri.

Due stringhe che contengono caratteri compresi tra "Z" e "a" nella tabella ASCII ('[', '\', ']', '^', '_' e '`') vengono confrontati in modo diverso, a seconda se sono in maiuscolo o minuscolo. Ad esempio, le due stringhe "ABCDE" e "ABCD^" vengono confrontate in un modo se il confronto è in minuscolo ("abcde" > "abcd^") e in un altro ("ABCDE" < "ABCD^") se è in maiuscolo.

_mbsnbicmp riconosce le sequenze di caratteri multibyte in base alla tabella codici multibyte attualmente in uso. Non viene influenzata dalle impostazioni locali correnti.

Se string1 o string2 è un puntatore Null, _mbsnbicmp richiama il gestore di parametri non validi, come descritto in Convalida dei parametri. Se l'esecuzione può continuare, la funzione restituisce _NLSCMPERROR e imposta errno su EINVAL.

Mapping di routine di testo generico