_mbsnbcmp, _mbsnbcmp_l

Article
06/09/2015

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

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 (éventuellement en anglais).

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

Paramètres

string1, string2
Chaînes à comparer.
count
Nombre d'octets à comparer.
locale
Paramètres régionaux à utiliser.

Valeur de retour

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

Notes

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 );
}

Sortie

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