_strnicoll, _wcsnicoll, _mbsnicoll, _strnicoll_l, _wcsnicoll_l, _mbsnicoll_l

Articolo
03/26/2013

Confrontare le stringhe utilizzando informazioni specifiche delle impostazioni locali.

Importante
_mbsnicoll e _mbsnicoll_l non possono essere utilizzati nelle applicazioni eseguite nelle finestre runtime.Per ulteriori informazioni, vedere Funzioni CRT non supportate con /ZW.

int _strnicoll(
   const char *string1,
   const char *string2,
   size_t count 
);
int _wcsnicoll(
   const wchar_t *string1,
   const wchar_t *string2 ,
   size_t count 
);
int _mbsnicoll(
   const unsigned char *string1,
   const unsigned char *string2,
   size_t count 
);
int _strnicoll_l(
   const char *string1,
   const char *string2,
   size_t count,
   _locale_t locale
);
int _wcsnicoll_l(
   const wchar_t *string1,
   const wchar_t *string2 ,
   size_t count,
   _locale_t locale
);
int _mbsnicoll_l(
   const unsigned char *string1,
   const unsigned char *string2,
   size_t count,
   _locale_t locale
);

Parametri

string1, string2
Stringhe con terminazione null da confrontare
count
Numero di caratteri da confrontare
locale
Le impostazioni locali da utilizzare.

Valore restituito

Ognuna di queste funzioni restituisce un valore che indica la relazione delle sottostringhe di string1 e di string2*,* come segue.

Valore restituito	Relazione di stringa1 e stringa2
< 0	string1 minore di string2
0	string1 uguale a string2
> 0	string1 è maggiore di string2

Ognuno di questi restituisce _NLSCMPERRORdi funzioni.Per utilizzare _NLSCMPERROR, includere STRING.H o. MBSTRING.H._wcsnicoll può non riuscire se string1 o string2 contiene i codici di caratteri al di fuori del dominio della sequenza di ordinamento.Quando si verifica un errore, _wcsnicoll può impostare errno a EINVAL.Per verificare un errore in una chiamata a _wcsnicoll, impostare errno a 0 e verificare errno dopo aver chiamato _wcsnicoll**.**

Note

Ognuna di queste funzioni esegue un confronto senza distinzione tra maiuscole e minuscole dei primi caratteri di count in string1 e in string2 in base alla tabella codici.Queste funzioni devono essere utilizzate solo quando esiste una differenza tra l'ordine del set di caratteri e l'ordine dei caratteri lessicografico nella tabella codici e questa differenza è di particolare interesse per il confronto di stringhe.Le versioni di queste funzioni senza il suffisso di _l utilizzano le impostazioni locali e la tabella codici corrente.Le versioni con il suffisso di_l sono identiche ma utilizzano le impostazioni locali passate in alternativa.Per ulteriori informazioni, vedere Impostazioni locali.

Tutte queste funzioni convalidano i relativi parametri.Se string1 o string2 è un puntatore null, o se il numero è maggiore di INT_MAX, il gestore non valido di parametro viene richiamato, come descritto in Convalida dei parametri.Se l'esecuzione è consentita per continuare, queste funzioni _NLSCMPERROR di ritorno e errno stabilito a EINVAL**.**

Mapping di routine a Testo generico