_strncoll, _wcsncoll, _mbsncoll, _strncoll_l, _wcsncoll_l, _mbsncoll_l
comparar cadeias de caracteres usando informações específicas de localidade.
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
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 qualquer uma STRING.H ou MBSTRING.H. _wcsncoll 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, _wcsncoll pode conjunto errno para EINVAL. Para verificar se há um erro em uma telefonar para _wcsncoll, conjunto errno como 0 e, em seguida, verificar errno Após a telefonar _wcsncoll**.**
Comentários
Cada uma dessas funções efetua uma comparação diferenciando diferenciar maiúsculas de minúsculas do primeiro count caracteres em string1 e string2 de acordo com para a página de código atualmente em uso. 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.A ordem de conjunto de caractere é dependente de localidade.As versões dessas funções sem o _l uso de sufixo a localidade corrente; 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 ou contagem é maior que INT_MAX, o manipulador de parâmetro inválido é chamado, conforme 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 |
---|---|---|---|
_tcsnccoll |
_strncoll |
_mbsncoll |
_wcsncoll |
_tcsncoll |
_strncoll |
_wcsncoll |
Requisitos
Rotina |
Cabeçalho necessário |
---|---|
_strncoll, _strncoll_l |
<string.h> |
_wcsncoll, _wcsncoll_l |
<wchar.h> ou <string.h> |
_mbsncoll, _mbsncoll_l |
<mbstring.h> |
Para obter informações adicionais compatibilidade, consulte Compatibilidade na introdução.
Equivalente do NET Framework
Consulte também
Referência
Manipulação de seqüência de caracteres (CRT)
_mbsnbcoll, _mbsnbcoll_l, _mbsnbicoll, _mbsnbicoll_l
_stricmp, _wcsicmp, _mbsicmp, _stricmp_l, _wcsicmp_l, _mbsicmp_l
strncmp, wcsncmp, _mbsncmp, _mbsncmp_l
_strnicmp, _wcsnicmp, _mbsnicmp, _strnicmp_l, _wcsnicmp_l, _mbsnicmp_l