_mbsnbicmp, _mbsnbicmp_l

Artigo
08/25/2010

Compara n bytes de duas cadeias de caractere de multibyte, ignorando o caso.

int _mbsnbicmp(
   const unsigned char *string1,
   const unsigned char *string2,
   size_t count 
);

Parâmetros

string1, string2
Seqüências de terminação nula para comparar.
count
Número de bytes para comparar.

Valor de retorno

O valor retornado indica a relação entre as subseqüências.

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 _mbsnbicmp função lexicograficamente compara, no máximo, o primeiro count bytes de string1 e string2. A comparação será realizada sem consideração aos caso; _mbsnbcmp é uma versão de distinção entre diferenciar diferenciar maiúsculas de minúsculas _mbsnbicmp. A comparação termina se um caractere nulo de terminação é alcançado em qualquer seqüência de caracteres antes de count caracteres são comparadas. Se as seqüências de caracteres são iguais quando um caractere nulo de terminação for atingido em qualquer seqüência de caracteres antes de count caracteres são comparadas, a seqüência de caracteres mais curta é menor.

_mbsnbicmp é semelhante a _mbsnicmp, exceto que compara seqüências por bytes em vez de por caracteres.

Duas seqüências de caracteres contendo caracteres localizado entre 'Z' e 'a' na tabela ASCII (' [',' \ ','] ',' ^ ', '_' e ' ` ') comparar diferente, dependendo do seu caso.Por exemplo, as duas seqüências de caracteres"ABCDE"e"ABCD^"comparar uma maneira de se comparar for (em minúsculas"abcde" > "abcd^") e Outros (de forma"ABCDE" < "ABCD^") se for maiúscula.

_mbsnbicmp reconhece as seqüências de caractere multibyte acordo com o página de código multibyte atualmente em uso.Ele não é afetado pela configuração de localidade corrente.

Se qualquer um dos string1 ou string2 é um ponteiro nulo, _mbsnbicmp 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 conjuntos errno para EINVAL.

Mapeamentos de rotina de texto genérica

Rotina tchar.h	_UNICODE e _MBCS não definido	_MBCS definido	_UNICODE definido
_tcsnicmp	_strnicmp	_mbsnbicmp	_wcsnicmp
_tcsnicmp_l	_strnicmp_l	_mbsnbicmp_l	_wcsnicmp_l

Requisitos

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

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

Exemplo

Consulte o exemplo para _mbsnbcmp, _mbsnbcmp_l.

Equivalente do NET Framework

Não aplicável. Para telefonar a função C padrão, use PInvoke. Para obter mais informações, consulte Exemplos de invocação de plataforma.

Consulte também

Referência

Manipulação de seqüência de caracteres (CRT)

_mbsnbcat, _mbsnbcat_l

_mbsnbcmp, _mbsnbcmp_l

_stricmp, _wcsicmp, _mbsicmp, _stricmp_l, _wcsicmp_l, _mbsicmp_l

Compartilhar via