_strnicmp, _wcsnicmp, _mbsnicmp, _strnicmp_l, _wcsnicmp_l, _mbsnicmp_l

Artigo
02/25/2013

Compara caracteres de duas cadeias de caracteres sem considerar aos casos.

Importante
_mbsnicmp e _mbsnicmp_l não podem ser usados em aplicativos que executam em Tempo de Execução do Windows.Para obter mais informações, consulte Funções de CRT não suportadas com /ZW.

int _strnicmp( const char *string1, const char *string2, size_t count ); int _wcsnicmp( const wchar_t *string1, const wchar_t *string2, size_t count ); int _mbsnicmp( const unsigned char *string1, const unsigned char *string2, size_t count ); int _strnicmp_l( const char *string1, const char *string2, size_t count, _locale_t locale ); int _wcsnicmp_l( const wchar_t *string1, const wchar_t *string2, size_t count, _locale_t locale ); int _mbsnicmp_l( const unsigned char *string1, const unsigned char *string2, size_t count, _locale_t locale );

Parâmetros

string1, string2
Cadeias de caracteres NULL- terminadas para comparar.
count
Número de caracteres para comparar.
locale
A localidade usar.

Valor de retorno

Indica a relação entre as subcadeias de caracteres, como segue.

Valor de Retorno	Descrição
< 0	a subcadeia de caracteres destring1 for menor do que a subcadeia de caracteres de string2 .
0	a subcadeia de caracteres destring1 é idêntica a subcadeia de caracteres de string2 .
> 0	a subcadeia de caracteres destring1 é maior do que a subcadeia de caracteres de string2 .

Em um erro, _mbsnicmp retorna _NLSCMPERROR, que é definido em STRING.H e em MBSTRING.H.

Comentários

A função de _strnicmp compara lexicographically, no máximo, os primeiros caracteres de count de string1 e string2.Comparação é executada sem consideração a caso; _strnicmp é uma versão sem diferenciação de maiúsculas e minúsculas de strncmp.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.

Os caracteres de 91 a 96 na tabela ASCII (“[”, “\ \”, “]”, “^”, “_”, “e “") como um valor menor do que qualquer caractere alfabético.Isso de ordenação é idêntico ao de stricmp.

_wcsnicmp e _mbsnicmp são versões de largo- caracteres e de multibyte- caractere de _strnicmp.Os argumentos e o valor de retorno de _wcsnicmp são cadeias de caracteres de largo- caracteres; essas de _mbsnicmp são cadeias de caracteres de multibyte- caractere._mbsnicmp reconhece sequências de multibyte- caractere de acordo com a página de código atual de multibyte e retorna _NLSCMPERROR em um erro.Para obter mais informações, consulte Páginas de código.Essas três funções se comportam de forma idêntica.Essas funções são afetados por versões de configuração - de localidade que não têm o uso do sufixo de _l a localidade atual para o comportamento de são dependentes; as versões que têm o sufixo de _l usar a localidade dentro que é passada.Para obter mais informações, consulte Localidade.

Todas essas funções validam seus parâmetros.Se string1 ou string2 são um ponteiro zero, o manipulador inválido do parâmetro é invocado, como descrito em Validação de parâmetro.Se a execução é permitida continuar, essas funções _NLSCMPERROR de retorno e errno defina a EINVAL.

Mapeamentos da rotina de Genérico- texto