_strnicoll, _wcsnicoll, _mbsnicoll, _strnicoll_l, _wcsnicoll_l, _mbsnicoll_l

Artigo
02/25/2013

Compare cadeias de caracteres usando as informações específicas.

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

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 NULL- terminadas para comparar
count
Número de caracteres para comparar
locale
A localidade a ser usada.

Valor de retorno

Cada uma dessas funções retorna um valor que indica a relação entre as subcadeias de caracteres de string1 e de string2*,* como segue.

Valor de Retorno	Relacionamento de string1 a string2
< 0	string1 menor que string2
0	string1 idêntico a string2
> 0	string1 maior do que string2

Cada um desses retorna _NLSCMPERRORde funções.Para usar _NLSCMPERROR, inclua STRING.H ou. MBSTRING.H._wcsnicoll pode falhar se string1 ou string2 contêm o código de largo- caractere fora do domínio de sequência de comparação.Quando ocorre um erro, _wcsnicoll pode definir errno a EINVAL.Para verificar se há um erro em uma chamada para _wcsnicoll, defina a errno 0 e então verifica errno após chamar _wcsnicoll**.**

Comentários

Cada uma dessas funções executa uma comparação que não diferencia maiúsculas de minúsculas dos primeiros caracteres de count em string1 e em string2 de acordo com a página de código.Essas funções devem ser usadas somente quando há uma diferença entre ordem do conjunto de caracteres e ordem lexicographic de caracteres na página de código e essa diferença é de interesse para comparação de cadeia de caracteres.As versões dessas funções sem o sufixo de _l usam a localidade e a página de código atual.As versões com o sufixo de_l são idênticas exceto que usam a localidade passada no lugar.Para obter mais informações, consulte Localidade.

Todas essas funções validam seus parâmetros.Se string1 ou string2 são um ponteiro zero, ou se o número for maior do que INT_MAX, 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