_mbsnbicmp, _mbsnbicmp_l
Compara os bytes de n de duas cadeias de caracteres de multibyte- caractere, ignorando casos.
Importante |
---|
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)
_stricmp, _wcsicmp, _mbsicmp, _stricmp_l, _wcsicmp_l, _mbsicmp_l