_mbsnbicmp, _mbsnbicmp_l

Artigo
06/09/2015

Compara n bytes de caracteres multibyte duas cadeias de caracteres e diferencia maiúsculas de minúsculas.

Importante

Esta API não pode ser usada em aplicativos executados no Tempo de Execução do Windows.Para obter mais informações, consulte Funções de CRT sem suporte com /ZW.

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

Parâmetros

string1, string2
Caracteres de terminação nula para comparar.
count
Número de bytes a ser comparado.

Valor de retorno

O valor de retorno indica a relação entre as subcadeias de caracteres.

Valor de retorno	Descrição
< 0	string1subcadeia de caracteres menor que string2 subcadeia de caracteres.
0	string1subcadeia de caracteres idêntica à string2 subcadeia de caracteres.
> 0	string1subcadeia de caracteres maior que string2 subcadeia de caracteres.

Em caso de erro, _mbsnbcmp retorna _NLSCMPERROR, que é definido em String. h e Mbstring.h.

Comentários

O _mbsnbicmp função executa uma comparação ordinal do primeiro no máximo count bytes de string1 e string2. A comparação é realizada, convertendo cada caractere em minúsculas; _mbsnbcmp é uma versão de maiúsculas e minúsculas do _mbsnbicmp. A comparação termina se um caractere nulo de terminação for atingido na cadeia de caracteres antes de count caracteres são comparados. Se as cadeias de caracteres são iguais quando um caractere nulo de terminação for alcançado na cadeia de caracteres antes de count caracteres são comparados, a cadeia de caracteres mais curta é menor.

_mbsnbicmp é semelhante a _mbsnicmp, exceto que ela compara cadeias de caracteres até count bytes em vez de caracteres.

Duas cadeias de caracteres que contém caracteres localizado entre 'Z' e 'a' na tabela ASCII ('[', ' \', ']', ' ^', '_' e ' ') comparar diferente, dependendo do seu caso. Por exemplo, duas cadeias de caracteres "ABCDE"e"ABCD^" comparar uma forma se a comparação é minúscula ("abcde" > "abcd^") e a outra forma ("ABCDE" < "ABCD^") se for maiúscula.

_mbsnbicmpreconhece sequências de caracteres multibyte de acordo com o página de código multibyte atualmente em uso. Ela não é afetada pela configuração de localidade atual.

Se qualquer um dos string1 ou string2 é um ponteiro nulo, _mbsnbicmp invoca o manipulador de parâmetro inválido, como descrito em Validação do parâmetro. Se a execução puder continuar, a função retornará _NLSCMPERROR e define errno para EINVAL.

Mapeamentos da rotina de texto genérico