_strncoll, _wcsncoll, _mbsncoll, _strncoll_l, _wcsncoll_l, _mbsncoll_l

Artigo
02/25/2013

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

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

int _strncoll( const char *string1, const char *string2, size_t count ); int _wcsncoll( const wchar_t *string1, const wchar_t *string2, size_t count ); int _mbsncoll( const unsigned char *string1, const unsigned char *string2, size_t count ); int _strncoll_l( const char *string1, const char *string2, size_t count, _locale_t locale ); int _wcsncoll_l( const wchar_t *string1, const wchar_t *string2, size_t count, _locale_t locale ); int _mbsncoll_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
O número de caracteres em 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._wcsncoll pode falhar se string1 ou string2 contêm os códigos de largo- caractere que estão fora do domínio da sequência de comparação.Quando ocorre um erro, _wcsncoll pode definir errno a EINVAL.Para verificar se há um erro em uma chamada a _wcsncoll, defina errno a 0 e então verifica errno depois de você chamar _wcsncoll.

Comentários

Cada uma dessas funções executa uma comparação com diferenciação de maiúsculas e minúsculas dos primeiros caracteres de count em string1 e em string2, de acordo com a página de código que está atualmente em uso.Use essas funções somente quando há uma diferença entre ordem do conjunto de caracteres e ordem lexicographic de caracteres na página de código, e quando essa diferença é de interesse para comparação de cadeia de caracteres.A ordem de conjunto de caracteres é são dependentes.As versões dessas funções que não têm o uso do sufixo de _l a localidade atual, mas as versões que têm o uso do sufixo de _l a localidade dentro que é passada.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 count é 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