_strnicmp, _wcsnicmp, _mbsnicmp, _strnicmp_l, _wcsnicmp_l, _mbsnicmp_l

Articolo
03/26/2013

Confronta i caratteri di due stringhe indipendentemente dall'evento.

Importante
_mbsnicmp e _mbsnicmp_l non possono essere utilizzati nelle applicazioni eseguite in Windows Runtime.Per ulteriori informazioni, vedere Funzioni CRT non supportate con /ZW.

int _strnicmp(
   const char *string1,
   const char *string2,
   size_t count 
);
int _wcsnicmp(
   const wchar_t *string1,
   const wchar_t *string2,
   size_t count 
);
int _mbsnicmp(
   const unsigned char *string1,
   const unsigned char *string2,
   size_t count 
);
int _strnicmp_l(
   const char *string1,
   const char *string2,
   size_t count,
   _locale_t locale
);
int _wcsnicmp_l(
   const wchar_t *string1,
   const wchar_t *string2,
   size_t count,
   _locale_t locale
);
int _mbsnicmp_l(
   const unsigned char *string1,
   const unsigned char *string2,
   size_t count,
   _locale_t locale
);

Parametri

string1, string2
Stringhe che terminano con null da confrontare.
count
Numero di caratteri da confrontare.
locale
Impostazioni locali da utilizzare.

Valore restituito

Indica la relazione tra le sottostringhe, come segue.

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

In caso di errore, _mbsnicmp restituisce _NLSCMPERROR, definito in STRING.H e in MBSTRING.H.

Note

La funzione di _strnicmp lessicografico confronta, al massimo, i primi caratteri di count di string1 e string2.Il confronto viene eseguito indipendentemente dal caso; _strnicmp è una versione senza distinzione tra maiuscole e minuscole di strncmp.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.

I caratteri da 91 a 96 nella tabella ASCII (" [", "\", "]", "^", "_" e "o ") restituiscono minore di qualsiasi carattere alfabetico.Questo ordine è identico a quello di stricmp.

_wcsnicmp e _mbsnicmp sono versioni a caratteri di tipo "wide" e di caratteri multibyte di _strnicmp.Gli argomenti e il valore restituito di _wcsnicmp sono stringhe di caratteri di tipo "wide", quelli di _mbsnicmp sono stringhe di caratteri multibyte._mbsnicmp riconosce le sequenze di caratteri multibyte in base alla tabella del codice multibyte corrente e restituisce _NLSCMPERROR in caso di errore.Per ulteriori informazioni, vedere Tabelle codici.Altrimenti queste tre funzioni si comportano in modo identico.Queste funzioni sono interessate dalle versioni di impostazione delle impostazioni locali che non prevedono l'utilizzo di _l le impostazioni locali correnti per il comportamento dipendente dalle impostazioni locali; le versioni che hanno il suffisso di _l utilizzare invece le impostazioni locali passate in.Per ulteriori informazioni, vedere Impostazioni locali.

Tutte queste funzioni convalidano i relativi parametri.Se string1 o string2 è un puntatore null, il gestore non valido di parametro viene richiamato, come descritto in Convalida dei parametri.Se all'esecuzione è permesso continuare, queste funzioni restituiscono _NLSCMPERROR e impostano errno a EINVAL.

Mapping di routine a Testo generico