_mbsnbcmp, _mbsnbcmp_l

Artigo
08/25/2010

Compara o primeiro n bytes de duas cadeias de caractere de multibyte.

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

Parâmetros

string1, string2
Cadeias de caracteres para comparar.
count
Número de bytes para comparar.
locale
Localidade usar.

Valor de retorno

O valor retornado indica a relação de substrings de string1 e string.

Valor de Retorno	Descrição
< 0	string1 substring menor que string2 subseqüência.
0	string1 idêntico a substring string2 subseqüência.
> 0	string1 subseqüência de caracteres maior que string2 subseqüência.

Em um erro, _mbsnbcmp Retorna _NLSCMPERROR, que é definido em String.h e Mbstring.h.

Comentários

The _mbsnbcmp função lexicograficamente compara, no máximo, o primeiro count bytes em string1 e string2 e retorna um valor que indica a relação entre as subseqüências. _mbsnbcmp é uma versão de distinção entre diferenciar diferenciar maiúsculas de minúsculas _mbsnbicmp. Ao contrário de strcoll, _mbsnbcmp não é afetado pela localidade. _mbsnbcmp reconhece as seqüências de caractere multibyte de acordo com a multibyte corrente página de código.

_mbsnbcmp é semelhante a _mbsncmp, exceto pelo fato de que _mbsncmp compara as seqüências de caracteres por caracteres em vez de bytes.

O valor de saída é afetado pela configuração do LC_CTYPE categoria de configuração da localidade; consulte setlocale para obter mais informações.A versão dessa função sem o _l sufixo usa a localidade corrente para esse comportamento dependente de localidade; a versão com o _l sufixo é idêntico, exceto pelo fato de que ele utiliza o parâmetro de localidade passado em vez disso. Para obter mais informações, consulte Localidade.

Se qualquer um dos string1 ou string2 é um ponteiro nulo, essa função chama o manipulador de parâmetro inválido sistema autônomo descrito em Validação de parâmetro. Se a execução terá permissão para continuar, a função retornará _NLSCMPERROR e errno é definido como EINVAL.

Mapeamentos de rotina de texto genérica

Rotina tchar.h	_UNICODE e _MBCS não definido	_MBCS definido	_UNICODE definido
_tcsncmp	strncmp	_mbsnbcmp	wcsncmp
_tcsncmp_l	strncmp	_mbsnbcml	wcsncmp

Requisitos

Rotina	Cabeçalho necessário
_mbsnbcmp	<mbstring.h>
_mbsnbcmp_l	<mbstring.h>

Para obter mais informações de compatibilidade, consulte Compatibilidade na introdução.

Exemplo

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

Saída

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