Compartilhar via


_strnicmp, _wcsnicmp, _mbsnicmp, _strnicmp_l, _wcsnicmp_l, _mbsnicmp_l

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

Rotina TCHAR.H

_UNICODE & _MBCS não definido

_MBCS definido

_UNICODE definido

_tcsncicmp

_strnicmp

_mbsnicmp

_wcsnicmp

_tcsnicmp

_strnicmp

_mbsnbicmp

_wcsnicmp

_tcsncicmp_l

_strnicmp_l

_mbsnicmp_l

_wcsnicmp_l

Requisitos

Rotina

Cabeçalho necessário

_strnicmp, _strnicmp_l

<string.h>

_wcsnicmp, _wcsnicmp_l

<string.h> ou <wchar.h>

_mbsnicmp, _mbsnicmp_l

<mbstring.h>

Para obter informações adicionais compatibilidade, consulte Compatibilidade na introdução.

Exemplo

Consulte o exemplo para strncmp.

Equivalente do NET Framework

sistema::String::comparar

Consulte também

Referência

Manipulação de seqüência de caracteres (CRT)

strcat wcscat, _mbscat

strcmp wcscmp, _mbscmp

strcpy wcscpy, _mbscpy

strncat, _strncat_l, wcsncat, wcsncat_l, _mbsncat _mbsncat_l

strncmp, wcsncmp, _mbsncmp, _mbsncmp_l

funções strncpy, _strncpy_l, wcsncpy, _wcsncpy_l, _mbsncpy, _mbsncpy_l

strrchr, wcsrchr, _mbsrchr, _mbsrchr_l

_strset, _strset_l, _wcsset, _wcsset_l, _mbsset, _mbsset_l

strspn, wcsspn, _mbsspn, _mbsspn_l