_mbsnbicmp, _mbsnbicmp_l

 

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

Compare n octets de deux chaînes de caractères multioctets, en ignorant la casse.

System_CAPS_ICON_important.jpg Important

Cette API ne peut pas être utilisée dans les applications qui s'exécutent dans le Windows Runtime. Pour plus d'informations, voir 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 Null à comparer.

count
Nombre d'octets à comparer.

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

Valeur de retourDescription
< 0La sous-chaîne de string1 est inférieure à la sous-chaîne de string2.
0La sous-chaîne de string1 est identique à la sous-chaîne de string2.
> 0La sous-chaîne de string1 est supérieure à la sous-chaîne de string2.

En cas d'erreur, _mbsnbcmp retourne _NLSCMPERROR, qui est défini dans String.h et Mbstring.h.

La fonction _mbsnbicmp effectue une comparaison ordinale des count (au plus) premiers octets de string1 et de string2. La comparaison est effectuée en convertissant chaque caractère en minuscule ; _mbsnbcmp est une version de _mbsnbicmp qui respecte la casse. La comparaison se termine si un caractère null de fin est atteint dans l'une ou l'autre des chaînes avant que count caractères soient comparés. Si les chaînes sont égales quand un caractère null de fin est atteint dans l'une ou l'autre des chaînes avant que count caractères soient comparés, la chaîne la plus courte est considérée comme étant inférieure.

_mbsnbicmp est similaire à _mbsnicmp, sauf qu'elle compare des chaînes jusqu'à count octets au lieu de les comparer par caractères.

La comparaison de deux chaînes contenant des caractères qui se trouvent entre « Z » et « a » dans la table ASCII (« [ », « \ », « ] », « ^ », « _ » et « ' ») donne des résultats différents selon leur casse. Par exemple, les deux chaînes « ABCDE » et « ABCD^ » se comparent d'une certaine façon si la comparaison est en minuscules (« abcde » > « abcd^ ») et d'une autre façon (« ABCDE » < « ABCD^ ») si elle est en majuscules.

_mbsnbicmp reconnaît les séquences de caractères multioctets en fonction de la page de codes multioctets en cours d'utilisation. Elle n'est pas affectée par les paramètres régionaux actuels.

Si string1 ou string2 est un pointeur null, _mbsnbicmp appelle le gestionnaire de paramètres non valides, comme décrit dans Validation de paramètre. Si l'exécution est autorisée à continuer, cette fonction retourne _NLSCMPERROR et définit à 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
_tcsnicmp_strnicmp_mbsnbicmp_wcsnicmp
_tcsnicmp_l_strnicmp_l_mbsnbicmp_l_wcsnicmp_l
RoutineEn-tête requis
_mbsnbicmp<mbstring.h>

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

Consultez l'exemple relatif à _mbsnbcmp, _mbsnbcmp_l.

Non applicable. Pour appeler la fonction C standard, utilisez PInvoke. Pour plus d'informations, consultez Exemples d'appel de plateforme.

Manipulation de chaînes
_mbsnbcat, _mbsnbcat_l
_mbsnbcmp, _mbsnbcmp_l
_stricmp, _wcsicmp, _mbsicmp, _stricmp_l, _wcsicmp_l, _mbsicmp_l

Afficher: