_strnicmp, _wcsnicmp, _mbsnicmp, _strnicmp_l, _wcsnicmp_l, _mbsnicmp_l

Articolo
06/09/2015

Confronta i caratteri di due stringhe senza fare distinzione tra maiuscole e minuscole.

Importante

_mbsnicmp e _mbsnicmp_l non possono essere usati nelle applicazioni eseguite in Windows Runtime.Per altre informazioni, vedere l'argomento relativo alle 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 usare.

Valore restituito

Indica la relazione tra le sottostringhe, come indicato di seguito.

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 di convalida del parametro, queste funzioni restituiscono _NLSCMPERROR, definito in <string.h> e <mbstring.h>.

Note

La funzione _strnicmp esegue un confronto ordinale al massimo dei primi count caratteri di string1 e string2. Il confronto viene eseguito senza fare distinzione tra maiuscole e minuscole convertendo ogni carattere in minuscolo. _strnicmp è una versione di strncmp che non fa 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.

I caratteri da 91 a 96 nella tabella ASCII ('[', '\', ']', '^', '_' e '`') sono considerati minori rispetto a qualsiasi carattere alfabetico. Questo ordinamento è identico a quello di stricmp.

_wcsnicmp e _mbsnicmp sono le versioni a caratteri wide e a caratteri multibyte di _strnicmp. Gli argomenti di _wcsnicmp sono stringhe di caratteri wide, mentre gli argomenti di _mbsnicmp sono stringhe di caratteri multibyte. _mbsnicmp riconosce le sequenze di caratteri multibyte in base alla tabella codici multibyte corrente e restituisce _NLSCMPERROR in caso di errore. Per altre informazioni, vedere Tabelle codici. A parte ciò, queste tre funzioni si comportano in modo identico. Queste funzioni vengono influenzate dalle impostazioni locali: le versioni che non hanno il suffisso _l usano le impostazioni locali correnti per il relativo comportamento dipendente dalle impostazioni locali, mentre le versioni che hanno il suffisso _l usano il parametro locale passato dall'utente. Per altre informazioni, vedere Impostazioni locali.

Tutte queste funzioni convalidano i relativi parametri. Se string1 o string2 è un puntatore Null, viene richiamato il gestore di parametri non validi, come descritto in Convalida dei parametri. Se l'esecuzione può continuare, queste funzioni restituiscono _NLSCMPERROR e impostano errno su EINVAL.

Mapping di routine di testo generico