_mbsnbicmp, _mbsnbicmp_l

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

Importante

Non è possibile usare questa API nelle applicazioni eseguite in Windows Runtime. Per altre informazioni, vedere Funzioni CRT non supportate nelle app della piattaforma UWP (Universal Windows Platform).

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.

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, _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

Routine Tchar.h	_UNICODE e _MBCS non definito	_MBCS Definito	_UNICODE Definito
_tcsnicmp	_strnicmp	_mbsnbicmp	_wcsnicmp
_tcsnicmp_l	_strnicmp_l	_mbsnbicmp_l	_wcsnicmp_l

Requisiti

Ciclo	Intestazione obbligatoria
_mbsnbicmp	<mbstring.h>

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