Nous recommandons d’utiliser Visual Studio 2017

strcoll, wcscoll, _mbscoll, _strcoll_l, _wcscoll_l, _mbscoll_l

 

Date de publication : juillet 2016

Pour obtenir la dernière documentation sur Visual Studio 2017, consultez Documentation Visual Studio 2017.

Compare des chaînes à l’aide des paramètres régionaux actuels ou une catégorie d’état de la conversion LC_COLLATE spécifiée.

System_CAPS_ICON_important.jpg Important

_mbscoll et _mbscoll_l ne peuvent pas être utilisées dans les applications qui s'exécutent dans Windows Runtime. Pour plus d’informations, consultez Fonctions CRT non prises en charge avec /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   
);  

Paramètres

string1, string2
Chaîne terminée par Null à comparer.

locale
Paramètres régionaux à utiliser.

Chacune de ces fonctions retourne une valeur qui indique la relation de string1 à string2 , comme suit.

Valeur de retourRelation de chaîne1 à chaîne2
< 0string1 inférieure à string2
0string1 identique à string2
> 0string1 supérieur à string2

Chacune de ces fonctions retourne _NLSCMPERROR en cas d’erreur. Pour utiliser _NLSCMPERROR, inclure une chaîne. H ou MBSTRING. H. wcscollpeut échouer si le paramètre string1 ou string2 est NULL ou contient des codes de caractères larges en dehors du domaine de la séquence de classement. Quand une erreur se produit, wcscoll peut attribuer à errno la valeur EINVAL. Pour rechercher une erreur dans un appel à wcscoll, définissez errno à 0, puis vérifiez errno après avoir appelé wcscoll.

Chacune de ces fonctions effectue une comparaison respectant la casse de string1 et string2 en fonction de la page de codes en cours d’utilisation. Ces fonctions doivent être utilisées uniquement lorsqu’il existe une différence entre le caractère de définie l’ordre et l’ordre lexicographique des caractères dans la page de codes actuelle et cette différence revêt un intérêt pour la comparaison de chaînes.

Toutes ces fonctions valident leurs paramètres. Si le paramètre string1 ou string2 est un pointeur null, ou si count est supérieur à INT_MAX, le Gestionnaire de paramètre non valide est appelé, comme décrit dans Validation de paramètre . Si l'exécution est autorisée à se poursuivre, ces fonctions retournent _NLSCMPERROR et définissent errno avec la valeur EINVAL.

La comparaison des deux chaînes est une opération de dépendant des paramètres régionaux dans la mesure où chacun des paramètres régionaux a des règles différentes pour le classement des caractères. Les versions de ces fonctions sans le _l suffixe utilisez paramètres régionaux du thread actuel pour ce comportement dépendant des paramètres régionaux ; les versions avec le _l suffixe sont identiques à la fonction correspondante sans le suffixe, sauf qu’ils utilisent les paramètres régionaux transmis comme paramètre à la place les paramètres régionaux actuels. Pour plus d’informations, consultez Locale.

Mappages de routines de texte générique

Routine TCHAR.H_UNICODE et _MBCS non définis_MBCS défini_UNICODE défini
_tcscollstrcoll_mbscollwcscoll
RoutineEn-tête requis
strcoll<string.h>
wcscoll<wchar.h>,<string.h></string.h></wchar.h>
_mbscoll, _mbscoll_l<mbstring.h>
_strcoll_l<string.h>
_wcscoll_l<wchar.h>,<string.h></string.h></wchar.h>

Pour plus d'informations sur la compatibilité, voir Compatibilité.

System::String::compare

Paramètres régionaux
Manipulation de chaînes
strcoll (fonctions)
localeconv
_mbsnbcoll, _mbsnbcoll_l, _mbsnbicoll, _mbsnbicoll_l
SetLocale, _wsetlocale
strcmp, wcscmp, _mbscmp
_stricmp, _wcsicmp, _mbsicmp, _stricmp_l, _wcsicmp_l, _mbsicmp_l
strncmp, wcsncmp, _mbsncmp, _mbsncmp_l
_strnicmp, _wcsnicmp, _mbsnicmp, _strnicmp_l, _wcsnicmp_l, _mbsnicmp_l
strxfrm, wcsxfrm, _strxfrm_l, _wcsxfrm_l

Afficher: