_strnicoll, _wcsnicoll, _mbsnicoll, _strnicoll_l, _wcsnicoll_l, _mbsnicoll_l

Article
03/26/2013

Comparez des chaînes à l'aide de informations spécifiques aux paramètres régionaux.

Important

_mbsnicoll et _mbsnicoll_l ne peuvent pas être utilisés dans les applications qui s'exécutent dans les fenêtres d'exécution.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 le caractère NULL à comparer
count
Nombre de caractères à comparer
locale
Les paramètres régionaux à utiliser.

Valeur de retour

Chacune de ces fonctions retourne une valeur indiquant la relation des sous-chaînes d' string1 et d' string2*,* comme suit.

Valeur de retour	Relation de string1 à chaîne2
< 0	string1 moins qu' string2
0	string1 identique à string2
> 0	string1 supérieur string2

Chacune de ces fonctions retourne _NLSCMPERROR.Pour utiliser _NLSCMPERROR, incluez STRING.H ou MBSTRING.H._wcsnicoll peut échouer si string1 ou string2 contient du code à caractère élargi en dehors de le champ de la séquence assemblante.Lorsqu'une erreur se produit, _wcsnicoll peut définir errno à EINVAL.Pour vérifier une erreur dans un appel à _wcsnicoll, affectez errno à 0 puis vérifiez errno après avoir appelé _wcsnicoll**.**

Notes

Chacune de ces fonctions effectue une comparaison ne respectant pas la casse des premiers caractères d' count dans string1 et string2 d'après la page de codes.Ces fonctions doivent être utilisées uniquement lorsqu'il existe une différence entre l'ordre du jeu de caractères et l'ordre des caractères lexicographiques dans la page de codes et cette différence est intéressante pour la comparaison de chaînes.Les versions de ces fonctions sans suffixe d' _l utilisent les paramètres régionaux et la page de codes actuels.Les versions avec le suffixe d'_l sont identiques sauf qu'elles utilisent les paramètres régionaux passés à la place.Pour plus d'informations, consultez Paramètres régionaux.

Toutes ces fonctions valident leurs paramètres.Si 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 des paramètres .Si est autorisé à l'exécution pour continuer, ces fonctions _NLSCMPERROR de retour et affectez errno à EINVAL**.**

Mappages de routines de texte générique