Partilhar via


_strnicoll, _wcsnicoll, _mbsnicoll, _strnicoll_l, _wcsnicoll_l, _mbsnicoll_l

comparar cadeias de caracteres usando informações específicas de localidade.

int _strnicoll(
   const char *string1,
   const char *string2,
   size_t count 
);
int _wcsnicoll(
   const wchar_t *string1,
   const wchar_t *string2 ,
   size_t count 
);
int _mbsnicoll(
   const unsigned char *string1,
   const unsigned char *string2,
   size_t count 
);
int _strnicoll_l(
   const char *string1,
   const char *string2,
   size_t count,
   _locale_t locale
);
int _wcsnicoll_l(
   const wchar_t *string1,
   const wchar_t *string2 ,
   size_t count,
   _locale_t locale
);
int _mbsnicoll_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
    A localidade para usar.

Valor de retorno

Cada uma dessas funções retorna um valor que indica o Relação das subseqüências de string1 e string2*,* sistema autônomo a seguir.

Valor de Retorno

Relação de seqüência1 para seqüência2

< 0

string1 menor que string2

0

string1 idêntico a string2

> 0

string1 maior que string2

Cada uma dessas funções retornará _NLSCMPERROR. Para usar _NLSCMPERROR, incluir STRING.H ou MBSTRING.H. _wcsnicoll pode falhar se qualquer uma string1 ou string2 contém códigos de caractere largo fora do domínio da sequência de agrupamento. Quando ocorre um erro, _wcsnicoll pode conjunto errno para EINVAL. Para verificar se há um erro em uma telefonar para _wcsnicoll, conjunto errno como 0 e, em seguida, verificar errno Após a telefonar _wcsnicoll**.**

Comentários

Cada uma dessas funções efetua uma comparação não diferencia maiúsculas de minúsculas da primeira count caracteres em string1 e string2 de acordo com a página de código. Essas funções devem ser usadas somente quando há uma diferença entre o caractere definido ordem e a ordem de caractere lexicographic na página de código e essa diferença é de interesse para a comparação de cadeia de caracteres de caracteres.As versões dessas funções sem o _l sufixo use a página de código e localidade corrente. As versões com o _l sufixo são idênticas exceto que eles usam a localidade do passado em vez disso. For more information, see Localidade.

Todas essas funções validar seus parâmetros.Se qualquer um dos string1 ou string2 é um ponteiro nulo, ou se a contagem é maior do que INT_MAX, 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

_tcsncicoll

_strnicoll

_mbsnbicoll

_wcsnicoll

_tcsnicoll

_strnicoll

_mbsnbicoll

_wcsnicoll

_tcsnicoll_l

_strnicoll_l

_mbsnbicoll_l

_wcsnicoll_l

Requisitos

Rotina

Cabeçalho necessário

_strnicoll, _strnicoll_l

<string.h>

_wcsnicoll, _wcsnicoll_l

<wchar.h> ou <string.h>

_mbsnicoll, _mbsnicoll_l

<mbstring.h>

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

Equivalente do NET Framework

sistema::String::comparar

Consulte também

Referência

Localidade

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

Funções strcoll

localeconv

_mbsnbcoll, _mbsnbcoll_l, _mbsnbicoll, _mbsnbicoll_l

setlocale, _wsetlocale

strcmp wcscmp, _mbscmp

_stricmp, _wcsicmp, _mbsicmp, _stricmp_l, _wcsicmp_l, _mbsicmp_l

strncmp, wcsncmp, _mbsncmp, _mbsncmp_l

_strnicmp, _wcsnicmp, _mbsnicmp, _strnicmp_l, _wcsnicmp_l, _mbsnicmp_l

strxfrm, wcsxfrm, _strxfrm_l, _wcsxfrm_l