Compartilhar via


_stricoll, _wcsicoll, _mbsicoll, _stricoll_l, _wcsicoll_l, _mbsicoll_l

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

Observação importanteImportante

_mbsicoll e _mbsicoll_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 _stricoll( const char *string1, const char *string2 ); int _wcsicoll( const wchar_t *string1, const wchar_t *string2 ); int _mbsicoll( const unsigned char *string1, const unsigned char *string2 ); int _stricoll_l( const char *string1, const char *string2, _locale_t locale ); int _wcsicoll_l( const wchar_t *string1, const wchar_t *string2, _locale_t locale ); int _mbsicoll_l( const unsigned char *string1, const unsigned char *string2, _locale_t locale );

Parâmetros

  • string1, string2
    Cadeias de caracteres NULL- terminadas para comparar.

  • locale
    A localidade a ser usada.

Valor de retorno

Cada uma dessas funções retorna um valor que indica a relação de string1 a 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

_NLSCMPERROR

Erro.

Cada um desses retorna _NLSCMPERRORde funções.Para usar _NLSCMPERROR, inclua STRING.H ou MBSTRING.H._wcsicoll 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, _wcsicoll pode definir errno a EINVAL.Para verificar se há um erro em uma chamada para _wcsicoll, defina a errno 0 e então verifica errno após chamar _wcsicoll.

Comentários

Cada uma dessas funções executa uma comparação que não diferencia maiúsculas de minúsculas de string1 e de string2 de acordo com a página de código atualmente em uso.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 atual e essa diferença é de interesse para comparação de cadeia de caracteres.

_stricmp difere de _stricoll da comparação de _stricmp é afetado por LC_CTYPE, enquanto a comparação de _stricoll está de acordo com as categorias de LC_CTYPE e de LC_COLLATE da localidade.Para obter mais informações sobre a categoria de LC_COLLATE , consulte setlocale e Categorias de localidade.As versões dessas funções sem o sufixo de _l usam a localidade 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 ponteiros de NULL , 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

Rotina de TCHAR.H

_UNICODE & _MBCS não definidos

_MBCS definido

_UNICODE definido

_tcsicoll

_stricoll

_mbsicoll

_wcsicoll

Requisitos

Rotina

Cabeçalho necessário

_stricoll, _stricoll_l

<string.h>

_wcsicoll, _wcsicoll_l

<wchar.h>, <string.h>

_mbsicoll, _mbsicoll_l

<mbstring.h>

Para informações extras de compatibilidade Compatibilidade na introdução, consulte.

Equivalência do .NET Framework

System::String::Compare

Consulte também

Referência

Localidade

Manipulação de cadeia de caracteres (CRT)

Funções de 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