_mbsnbicmp, _mbsnbicmp_l

Article
03/26/2013

Compare des octets d' n de deux chaînes de caractères multioctets, en ignorant le cas.

Important

Cette API ne peut pas être utilisée 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 _mbsnbicmp(
   const unsigned char *string1,
   const unsigned char *string2,
   size_t count 
);

Paramètres

string1, string2
Chaîne terminée par le caractère NULL à comparer.
count
Nombre d'octets à comparer.

Valeur de retour

La valeur de retour indique la relation entre les sous-chaînes.

Valeur de retour	Description
< 0	sous-chaîne d'string1 moins que la sous-chaîne d' string2 .
0	sous-chaîne d'string1 identique à la sous-chaîne d' string2 .
> 0	sous-chaîne d'string1 supérieure à la sous-chaîne d' string2 .

Sur une erreur, _mbsnbcmp retourne _NLSCMPERROR, qui est définie dans String.h et Mbstring.h.

Notes

La fonction d' _mbsnbicmpcompare lexicographique, au plus, les premiers octets d' count d' string1 et string2.La comparaison est exécutée sans tenir compte du cas ; _mbsnbcmpest une version non sensible à la casse d' _mbsnbicmp.La comparaison terminée si un caractère NULL de fin est atteint dans l'un ou l'autre de chaîne avant les caractères d' count sont comparés.Si les chaînes sont égales lorsqu'un caractère NULL de fin est atteint dans l'un ou l'autre de chaîne avant les caractères d' count sont comparés, la chaîne plus courte est moins.

_mbsnbicmpest semblable à _mbsnicmp, mais il compare des chaînes par les octets au lieu de caractères.

Deux chaînes contenant les caractères situés entre « Z » et « a » dans le tableau ASCII (" [ », « \ », « ] », « ^ », « _ », et '« ") sont considérés différemment, selon le cas.Par exemple, les deux chaînes « ABCDE » et « ABCD^ » comparent une méthode si la comparaison est en minuscules ("abcde » > « abcd^") et l'autre manière ("ABCDE » < « ABCD^") si elle est en majuscules.

_mbsnbicmpidentifie les séquences de caractères multioctets en fonction de page de codes multioctets en cours de utilisation.Il n'est pas affectée par les paramètres régionaux.

Si string1 ou string2 est un pointeur null, _mbsnbicmp appelle le gestionnaire de paramètre non valide comme décrit dans Validation des paramètres.Si est autorisé à l'exécution pour continuer, la fonction retourne _NLSCMPERRORet définit errno à EINVAL.

Mappages de routines de texte générique

Routine de Tchar.h	_UNICODE et non définis _MBCS	_MBCS défini	_UNICODE défini
_tcsnicmp	_strnicmp	_mbsnbicmp	_wcsnicmp
_tcsnicmp_l	_strnicmp_l	_mbsnbicmp_l	_wcsnicmp_l

Configuration requise

Routine	En-tête requis
_mbsnbicmp	<mbstring.h>

Pour plus d'informations de compatibilité, consultez l' Compatibilité dans l'introduction.

Exemple

Consultez l'exemple pour _mbsnbcmp, _mbsnbcmp_l.

Équivalent .NET Framework

Non applicable. Pour appeler la fonction C standard, utilisez PInvoke. Pour plus d'informations, consultez l' Exemples d'appel de code non managé.

Voir aussi

Référence

Manipulation de chaînes (CRT)

_mbsnbcat, _mbsnbcat_l

_mbsnbcmp, _mbsnbcmp_l

_stricmp, _wcsicmp, _mbsicmp, _stricmp_l, _wcsicmp_l, _mbsicmp_l

Partager via