Nous recommandons d’utiliser Visual Studio 2017

_strnicoll, _wcsnicoll, _mbsnicoll, _strnicoll_l, _wcsnicoll_l, _mbsnicoll_l

 

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

Compare les chaînes à partir des informations propres aux paramètres régionaux.

System_CAPS_ICON_important.jpg Important

_mbsnicoll et _mbsnicoll_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 _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  
);  

Paramètres

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

count
Nombre de caractères à comparer

locale
Paramètres régionaux à utiliser.

Chacune de ces fonctions retourne une valeur qui indique la relation des sous-chaînes de string1 et 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. Pour utiliser _NLSCMPERROR, inclure une chaîne. H ou MBSTRING. H. _wcsnicollpeut échouer si le paramètre string1 ou string2 contiennent des codes de caractères larges en dehors du domaine de la séquence de classement. Quand une erreur se produit, _wcsnicoll peut attribuer à errno la valeur EINVAL. Pour rechercher une erreur dans un appel à _wcsnicoll, définissez errno à 0, puis vérifiez errno après avoir appelé _wcsnicoll .

Chacune de ces fonctions effectue une comparaison respectant la casse de la première count les caractères de string1 et string2 en fonction de la page de codes. 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 et cette différence revêt un intérêt pour la comparaison de chaînes. Les versions de ces fonctions sans le _l suffixe utilisent la page de code et les paramètres régionaux en cours. Les versions avec le_l suffixe sont identiques, sauf qu’ils utilisent les paramètres régionaux passé à la place. Pour plus d’informations, consultez Locale.

Toutes ces fonctions valident leurs paramètres. Si le paramètre string1 ou string2 est un pointeur null, ou si le nombre 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 errno à EINVAL .

Mappages de routines de texte générique

Routine TCHAR.H_UNICODE et _MBCS non définis_MBCS défini_UNICODE défini
_tcsncicoll_strnicoll_mbsnbicoll_wcsnicoll
_tcsnicoll_strnicoll_mbsnbicoll_wcsnicoll
_tcsnicoll_l_strnicoll_l_mbsnbicoll_l_wcsnicoll_l
RoutineEn-tête requis
_strnicoll, _strnicoll_l<string.h>
_wcsnicoll, _wcsnicoll_l<wchar.h> ou <string.h>
_mbsnicoll, _mbsnicoll_l<mbstring.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: