_strnicoll, _wcsnicoll, _mbsnicoll, _strnicoll_l, _wcsnicoll_l, , _mbsnicoll_l

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

Sintaxe

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
Cadeias de caracteres com encerramento nulo a serem comparadas

count
Número de caracteres a ser comparado

locale
A localidade a ser usada.

Valor retornado

Cada uma dessas funções retorna um valor que indica a relação das subcadeias de caracteres de string1 e string2, da seguinte maneira.

Cada uma dessas funções retorna _NLSCMPERROR. Para usar _NLSCMPERROR, inclua STRING.H ou MBSTRING.H. _wcsnicoll pode falhar se string1 ou string2 contém códigos de caractere largo fora do domínio da sequência de agrupamento. Quando um erro ocorre, _wcsnicoll pode definir errno para EINVAL. Para verificar se há um erro em uma chamada para _wcsnicoll, defina errno como 0 e, em seguida, verifique errno depois de chamar _wcsnicoll.

Comentários

Cada uma dessas funções executa uma comparação não diferencia maiúsculas e minúsculas dos primeiros 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 a ordem do conjunto de caracteres e a ordem dos caracteres lexicográficos na página de código e essa diferença é de interesse para a comparação de strings. As versões dessas funções sem o sufixo _l usam a localidade atual e a página de código. As versões com o _l sufixo são idênticas, exceto que usam a localidade passada. Para obter mais informações, consulte Localidade.

Todas essas funções validam seus parâmetros. Se or string1 string2 for um ponteiro nulo ou se count for maior que INT_MAX, o manipulador de parâmetro inválido será invocado, conforme descrito em Validação de parâmetro. Se a execução puder continuar, essas funções retornarão _NLSCMPERROR e definirão errno para EINVAL.

Por padrão, o estado global dessa função tem como escopo o aplicativo. Para alterar esse comportamento, confira Estado global no CRT.

Mapeamentos de rotina de texto genérico

Requisitos

Para obter informações sobre compatibilidade, consulte Compatibilidade.

Confira também

Localidade
Manipulação de cadeia de caracteres
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