_mbsnbicmp, _mbsnbicmp_l
Compare n octets de deux chaînes de caractères multioctets, en ignorant la casse.
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.
Valeur de retour
La valeur de retour indique la relation entre les sous-chaînes.
Valeur de retour |
Description |
|---|---|
< 0 |
La sous-chaîne de string1 est inférieure à la sous-chaîne de string2. |
0 |
La sous-chaîne de string1 est identique à la sous-chaîne de string2. |
> 0 |
La 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.
Notes
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 |
Configuration requise
Routine |
En-tête requis |
|---|---|
_mbsnbicmp |
<mbstring.h> |
Pour plus d'informations sur la compatibilité, voir Compatibilité.
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 Exemples d'appel de plateforme.
Voir aussi
Référence
_stricmp, _wcsicmp, _mbsicmp, _stricmp_l, _wcsicmp_l, _mbsicmp_l