Exporter (0) Imprimer
Développer tout
and
div
eof
not
or
xor
Développer Réduire
Cet article a fait l'objet d'une traduction manuelle. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte. Informations supplémentaires.
Traduction
Source

_mbsnbicmp, _mbsnbicmp_l

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

Remarque importante 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  );

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 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.

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

Routine

En-tête requis

_mbsnbicmp

<mbstring.h>

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

Consultez l'exemple pour _mbsnbcmp, _mbsnbcmp_l.

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

Ajouts de la communauté

AJOUTER
Afficher:
© 2015 Microsoft