strcoll, wcscoll, _mbscoll, _strcoll_l, _wcscoll_l, _mbscoll_l

Articolo
03/26/2013

Confrontare le stringhe utilizzando le impostazioni locali correnti o di una determinata categoria dello stato di conversione di LC_CTYPE.

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

int strcoll(
   const char *string1,
   const char *string2 
);
int wcscoll(
   const wchar_t *string1,
   const wchar_t *string2 
);
int _mbscoll(
   const unsigned char *string1,
   const unsigned char *string2 
);
int _strcoll_l(
   const char *string1,
   const char *string2,
   _locale_t locale 
);
int wcscoll_l(
   const wchar_t *string1,
   const wchar_t *string2,
   _locale_t locale 
);
int _mbscoll_l(
   const unsigned char *string1,
   const unsigned char *string2,
   _locale_t locale 
);

Parametri

string1, string2
Stringhe che terminano con null da confrontare.
locale
Impostazioni locali da utilizzare.

Valore restituito

Ognuna di queste funzioni restituisce un valore che indica la relazione tra string1 e 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

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

Note

Ognuna di queste funzioni attualmente esegue un confronto con distinzione tra maiuscole e minuscole di string1 e di string2 in base alla tabella codici utilizzata.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 corrente e questa differenza è di particolare interesse per il confronto di stringhe.

Tutte queste funzioni convalidano i relativi parametri.Se string1 o string2 è un puntatore null, o se count è maggiore di INT_MAX, 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.

Il confronto tra le due stringhe è un'operazione impostazioni locali dipendente dalle impostazioni locali dispongono di regole diversi per ordinare i caratteri.Le versioni di queste funzioni senza il suffisso di _l utilizzano le impostazioni locali del thread corrente per questo comportamento dipendente dalle impostazioni locali; le versioni con il suffisso di _l sono identiche alla funzione corrispondente senza il suffisso con la differenza che utilizzano le impostazioni locali passate in come parametro alle impostazioni locali correnti.Per ulteriori informazioni, vedere Impostazioni locali.

Mapping di routine a Testo generico