_strncoll, _wcsncoll, _mbsncoll, _strncoll_l, _wcsncoll_l, _mbsncoll_l

Articolo
03/26/2013

Confronto di stringhe utilizzando informazioni specifiche delle impostazioni locali.

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

int _strncoll(
   const char *string1,
   const char *string2,
   size_t count 
);
int _wcsncoll(
   const wchar_t *string1,
   const wchar_t *string2,
   size_t count 
);
int _mbsncoll(
   const unsigned char *string1,
   const unsigned char *string2,
   size_t count 
);
int _strncoll_l(
   const char *string1,
   const char *string2,
   size_t count,
   _locale_t locale
);
int _wcsncoll_l(
   const wchar_t *string1,
   const wchar_t *string2,
   size_t count,
   _locale_t locale
);
int _mbsncoll_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
Il 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 è identico a string2.
> 0	string1 è maggiore di string2.

Ognuno di questi restituisce _NLSCMPERRORdi funzioni.Per utilizzare _NLSCMPERROR, includere STRING.h o MBSTRING.h._wcsncoll 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, _wcsncoll può impostare errno a EINVAL.Per verificare un errore in una chiamata a _wcsncoll, impostare errno a 0 e verificare errno dopo avere chiamato _wcsncoll.

Note

Ognuna di queste funzioni esegue un confronto con distinzione tra maiuscole e minuscole dei primi caratteri di count in string1 e in string2, come la tabella codici attualmente utilizzata.Utilizzare queste funzioni solo quando esiste una differenza tra l'ordine del set di caratteri e l'ordine dei caratteri lessicografico nella tabella codici e quando questa differenza è di particolare interesse per il confronto di stringhe.L'ordine del set di caratteri sia le impostazioni locali dipendente.Le versioni di queste funzioni che non prevedono l'utilizzo di _l le impostazioni locali correnti, ma le versioni con l'utilizzo di _l 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, o 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.

Mapping di routine a Testo generico