_mbsnbicmp, _mbsnbicmp_l

Articolo
03/26/2013

Confronta i byte di n di due stringhe di caratteri multibyte, trascuranti il caso.

Importante
Questa API non può essere utilizzata nelle applicazioni che vengono eseguite in Windows Runtime.Per ulteriori informazioni, vedere 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 tra le sottostringhe.

Valore restituito	Descrizione
< 0	sottostringa distring1 minore di sottostringa di string2.
0	sottostringa distring1 identica alla sottostringa di string2.
> 0	sottostringa distring1 maggiore della sottostringa di string2.

Su un errore, _mbsnbcmp restituisce _NLSCMPERROR, definito in String.h e in Mbstring.h.

Note

La funzione di _mbsnbicmplessicografico confronta, al massimo, il primo byte di count di string1 e string2.Il confronto viene eseguito indipendentemente dal caso; _mbsnbcmpè una versione con distinzione tra maiuscole e minuscole di _mbsnbicmp.Il confronto termina se un carattere di terminazione null viene raggiunto in qualsiasi stringa prima di caratteri di count vengono confrontati.Se le stringhe sono uguali quando un carattere di terminazione null viene raggiunto in qualsiasi stringa prima di caratteri di count a byte doppio, la stringa più breve è minore.

_mbsnbicmpè simile a _mbsnicmp, con la differenza che confrontano stringhe da byte anziché da caratteri.

Due stringhe che contengono caratteri trovano tra "Z" e "a" nella tabella ASCII (" [", "\", "]", "^", "_" e "o ") confronto in modo diverso, a seconda del caso.Ad esempio, le due stringhe "ABCDE" e "ABCD^" confrontare una modalità se il confronto è minuscolo ("abcde" > "abcd^") e viceversa ("ABCDE" < "ABCD^") se è maiuscolo.

_mbsnbicmpriconosce attualmente le sequenze di caratteri multibyte come tabella codici multibyte in uso.Non è interessata dall'impostazione locale corrente.

Se string1 o string2 è un puntatore null, _mbsnbicmp richiamato il gestore non valido di parametro come descritto in Convalida dei parametri.Se l'esecuzione è consentita per continuare, la funzione restituisce _NLSCMPERRORe imposta errno a EINVAL.

Mapping di routine a Testo generico

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

Requisiti

Routine	Intestazione obbligatoria
_mbsnbicmp	<mbstring.h>

Per ulteriori informazioni sulla compatibilità, vedere Compatibilità nell'introduzione.

Esempio

Vedere l'esempio relativo _mbsnbcmp, _mbsnbcmp_l.

Equivalente .NET Framework

Non applicabile. Per chiamare la funzione standard C, utilizzare PInvoke. Per ulteriori informazioni, vedere Esempi di Invocazione della Piattaforma.

Vedere anche

Riferimenti

Modifica delle stringhe (CRT)

_mbsnbcat, _mbsnbcat_l

_mbsnbcmp, _mbsnbcmp_l

_stricmp, _wcsicmp, _mbsicmp, _stricmp_l, _wcsicmp_l, _mbsicmp_l

Condividi tramite