_mbsnbicmp, _mbsnbicmp_l

  • Artigo

Compara os bytes de n de duas cadeias de caracteres de multibyte- caractere, ignorando casos.

Observação importanteImportante

Este API não pode ser usado em aplicativos executados em Tempo de Execução do Windows.Para obter mais informações, consulte Funções de CRT não suportadas com /ZW.

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

Parâmetros

  • string1, string2
    Cadeias de caracteres NULL- terminadas para comparar.

  • count
    Número de bytes para comparar.

Valor de retorno

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

Valor de Retorno

Descrição

< 0

subcadeia de caracteres destring1 menos da subcadeia de caracteres de string2 .

0

subcadeia de caracteres destring1 idêntica à subcadeia de caracteres de string2 .

> 0

subcadeia de caracteres destring1 maior do que a subcadeia de caracteres de string2 .

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

Comentários

A função de _mbsnbicmpcompara lexicographically, no máximo, os primeiros bytes de count de string1 e string2.Comparação é executada sem consideração ao caso; _mbsnbcmpé uma versão com maiúsculas de minúsculas _mbsnbicmp.A comparação termina se um caractere nulo de terminação for atingido em qualquer uma cadeia de caracteres antes que os caracteres de count são comparados.Se as cadeias de caracteres são iguais quando um caractere nulo de terminação for atingido em qualquer uma cadeia de caracteres antes que os caracteres de count são comparados, a cadeia de caracteres mais curta é menos.

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

Duas cadeias de caracteres que contêm os caracteres localizados entre “Z” e “a” na tabela ASCII (“{”, “\ \”, “]”, “^”, “_”, “e “") comparam diferente, dependendo dos casos.Por exemplo, as duas cadeias de caracteres “ABCDE” e “ABCD^” comparam uma maneira se a comparação é minúsculo (“”abcde> “abcd^") e outra forma (“”ABCDE< “ABCD^") se é maiúscula.

_mbsnbicmpreconhece sequências de multibyte- caractere de acordo com a página de códigos de multibyte atualmente em uso.Não é afetado pela configuração de localidade atual.

Se string1 ou string2 são um ponteiro zero, _mbsnbicmp chama o manipulador inválido de parâmetros como descrito em Validação de parâmetro.Se a execução é permitida continuar, a função retorna _NLSCMPERRORe defina errno a EINVAL.

Mapeamentos da rotina de Genérico- texto

Rotina de Tchar.h

_UNICODE e não definidos _MBCS

_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 mais informações, consulte Compatibilidade de compatibilidade na introdução.

Exemplo

Consulte o exemplo para _mbsnbcmp, _mbsnbcmp_l.

Equivalência do .NET Framework

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

Consulte também

Referência

Manipulação de cadeia de caracteres (CRT)

_mbsnbcat, _mbsnbcat_l

_mbsnbcmp, _mbsnbcmp_l

_stricmp, _wcsicmp, _mbsicmp, _stricmp_l, _wcsicmp_l, _mbsicmp_l