_mbsnbcmp, _mbsnbcmp_l
et
div
eof
not
or
xor
TOC
Réduire la table des matières
Développer la table des matières
Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez aussi afficher la version anglaise dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte.
Traduction
Anglais

_mbsnbcmp, _mbsnbcmp_l

 

Compare les n premiers octets de deux chaînes de caractères multioctets.

System_CAPS_importantImportant

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 _mbsnbcmp(
   const unsigned char *string1,
   const unsigned char *string2,
   size_t count 
);
int _mbsnbcmp_l(
   const unsigned char *string1,
   const unsigned char *string2,
   size_t count,
   _locale_t locale
);

string1, string2

Chaînes à comparer.

count

Nombre d'octets à comparer.

locale

Paramètres régionaux à utiliser.

La valeur de retour indique la relation ordinale entre les sous-chaînes de string1 et de string.

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 de validation d'un paramètre, _mbsnbcmp et _mbsnbcmp_l retournent _NLSCMPERROR, qui est défini dans <string.h> et dans <mbstring.h>.

Les fonctions _mbsnbcmp comparent au plus les count premiers octets de string1 et de string2, et retournent une valeur qui indique la relation entre les sous-chaînes.   _mbsnbcmp est une version respectant la casse de _mbsnbicmp.  Contrairement à _mbsnbcoll, _mbsnbcmp n'est pas affectée par l'ordre de classement des paramètres régionaux.   _mbsnbcmp reconnaît les séquences de caractères multioctets en fonction de la page de codes multioctet active.  

_mbsnbcmp ressemble à _mbsncmp, sauf que _mbsncmp compare des chaînes de caractères et non pas des octets.

La valeur de sortie est affectée par le paramètre de catégorie LC_CTYPE des paramètres régionaux, qui spécifie les octets de début et de fin des caractères multioctets.  Pour plus d'informations, consultez setlocale.  La fonction _mbsnbcmp utilise les paramètres régionaux actuels pour ce comportement dépendant des paramètres régionaux.  La fonction _mbsnbcmp_l est identique, sauf qu'elle utilise à la place le paramètre locale.  Pour plus d'informations, consultez Paramètres régionaux.  

Si string1 ou string2 est un pointeur null, ces fonctions appellent le gestionnaire de paramètres non valides, comme décrit dans Validation de paramètre.  Si l'exécution est autorisée à continuer, les fonctions retournent _NLSCMPERROR et errno est défini à EINVAL.  

Mappages de routines de texte générique

Routine Tchar.h

_UNICODE et _MBCS non définis

_MBCS défini

_UNICODE défini

_tcsncmp

strncmp

_mbsnbcmp

wcsncmp

_tcsncmp_l

strncmp

_mbsnbcml

wcsncmp

Configuration requise

Routine

En-tête requis

_mbsnbcmp

<mbstring.h>

_mbsnbcmp_l

<mbstring.h>

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

Exemple

// crt_mbsnbcmp.c
#include <mbstring.h>
#include <stdio.h>

char string1[] = "The quick brown dog jumps over the lazy fox";
char string2[] = "The QUICK brown fox jumps over the lazy dog";

int main( void )
{
   char tmp[20];
   int result;
   printf( "Compare strings:\n          %s\n", string1 );
   printf( "          %s\n\n", string2 );
   printf( "Function: _mbsnbcmp (first 10 characters only)\n" );
   result = _mbsncmp( string1, string2 , 10 );
   if( result > 0 )
      _mbscpy_s( tmp, sizeof(tmp), "greater than" );
   else if( result < 0 )
      _mbscpy_s( tmp, sizeof(tmp), "less than" );
   else
      _mbscpy_s( tmp, sizeof(tmp), "equal to" );
   printf( "Result:   String 1 is %s string 2\n\n", tmp );
   printf( "Function: _mbsnicmp _mbsnicmp (first 10 characters only)\n" );
   result = _mbsnicmp( string1, string2, 10 );
   if( result > 0 )
      _mbscpy_s( tmp, sizeof(tmp), "greater than" );
   else if( result < 0 )
      _mbscpy_s( tmp, sizeof(tmp), "less than" );
   else
      _mbscpy_s( tmp, sizeof(tmp), "equal to" );
   printf( "Result:   String 1 is %s string 2\n\n", tmp );
}

Compare strings:
          The quick brown dog jumps over the lazy fox
          The QUICK brown fox jumps over the lazy dog

Function: _mbsnbcmp (first 10 characters only)
Result:   String 1 is greater than string 2

Function: _mbsnicmp _mbsnicmp (first 10 characters only)
Result:   String 1 is equal to string 2

Équivalent .NET Framework

Non applicable. Pour appeler la fonction C standard, utilisez PInvoke. Pour plus d'informations, consultez Platform Invoke Examples.

Afficher:
© 2016 Microsoft