_strnicmp, _wcsnicmp, _mbsnicmp, _strnicmp_l, _wcsnicmp_l, _mbsnicmp_l

Artigo
08/25/2010

comparar os caracteres de duas seqüências de caracteres sem considerar a caso.

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
Seqüências de terminação nula para comparar.
count
Número de caracteres para comparar.
locale
Localidade usar.

Valor de retorno

Indica a relação entre sistema autônomo subseqüências da seguinte maneira.

Valor de Retorno	Descrição
< 0	string1 substring menor que string2 substring
0	string1 idêntico a substring string2 substring
> 0	string1 subseqüência de caracteres maior que string2 substring

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

Comentários

The _strnicmp função lexicograficamente compara, no máximo, o primeiro count caracteres do string1 e string2*.* A comparação será realizada sem consideração aos caso; _strnicmp é uma versão não diferencia maiúsculas de minúsculas do strncmp. 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.

sistema autônomo caracteres de 91 para 96 da tabela ASCII (' [',' \ ','] ',' ^ ', '_' e ' ` ') avaliará sistema autônomo menor do que qualquer caractere alfabético.Essa ordem é idêntico ao que stricmp.

_wcsnicmp e _mbsnicmpsão versões de caractere largo e caracteres de multibyte de _strnicmp. Os argumentos e o valor retornado do _wcsnicmp são caractere largos strings; as de _mbsnicmp são seqüências de caractere de multibyte. _mbsnicmp reconhece seqüências de caractere multibyte de acordo com a página de código multibyte corrente e retorna _NLSCMPERROR em um erro. Para obter mais informações, consulte Páginas de código.Especifique estas três funções identicamente outro comportam.Essas funções são afetadas pela configuração de localidade.As versões sem o _l sufixo usam a localidade corrente para seu comportamento dependente de localidade. As versões com o _l sufixo são idênticas exceto que eles usam a localidade do passado em vez disso. Para obter mais informações, consulte Localidade.

Todas essas funções validar seus parâmetros.Se qualquer um dos string1 ou string2 é um ponteiro nulo, o manipulador de parâmetro inválido é invocado, sistema autônomo descrito em Validação de parâmetro. Se a execução for permitida para continuar, essas funções retornam _NLSCMPERROR e conjunto errno para EINVAL.

Mapeamentos de rotina de texto genérica