_mbsnbicmp, _mbsnbicmp_l

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

Sintassi

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.

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

Osservazioni:

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 _mbsnbcmp, ad eccezione del fatto che confronta le stringhe fino a count byte anziché per caratteri.

Due stringhe contenenti caratteri che si trovano tra 'Z' e 'a' nella tabella ASCII ('[', '\', ']', '^', '_'e '') vengono confrontate in modo diverso, a seconda del caso. Ad esempio, le due stringhe "ABCDE" e "ABCD^" confrontano un modo se il confronto è minuscolo ("abcde" > "abcd^") e l'altro modo ("ABCDE" < "ABCD^") se è maiuscolo.

_mbsnbicmp riconosce le sequenze di caratteri multibyte in base alla tabella codici multibyte attualmente in uso. Non è interessato dall'impostazione delle impostazioni locali correnti.

string1 Se 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.

Per impostazione predefinita, lo stato globale di questa funzione è limitato all'applicazione. Per modificare questo comportamento, vedere Stato globale in CRT.

Mapping di routine di testo generico

Requisiti

Per altre informazioni sulla compatibilità, vedere Compatibility (Compatibilità).

Esempio

Vedere l'esempio per _mbsnbcmp, _mbsnbcmp_l.

Vedi anche

Manipolazione delle stringhe
_mbsnbcat, _mbsnbcat_l
_mbsnbcmp, _mbsnbcmp_l
_stricmp, _wcsicmp, _mbsicmp, _stricmp_l, _wcsicmp_l_mbsicmp_l