Método CHString::Collate (chstring.h)
[A classe CHString faz parte do WMI Provider Framework que agora é considerado em estado final e nenhum desenvolvimento, melhoria ou atualização adicional estará disponível para problemas não relacionados à segurança que afetarem essas bibliotecas. As APIs de MI devem ser usadas em todos os novos desenvolvimentos.]
O método Collate usa a função wcscoll para comparar uma cadeia de caracteres CHString com outra cadeia de caracteres.
Sintaxe
int Collate(
LPCWSTR lpsz
);
Parâmetros
lpsz
A outra cadeia de caracteres usada para comparação.
Retornar valor
O método Collate retorna os valores a seguir.
Comentários
O método Collate executa uma comparação que diferencia maiúsculas de minúsculas das cadeias de caracteres de acordo com a página de código atualmente em uso.
Exemplos
O exemplo de código a seguir mostra como usar CHString::Collate:
CHString str1 = L"co-op";
CHString str2 = L"con";
int n;
// collation uses language rules, such as ignoring dashes
n = str1.Collate(str2);
assert(n > 0);
// comparison is a strict ASCII comparison with no language rules
n = str1.Compare(str2);
assert(n < 0);
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows Vista |
| Servidor mínimo com suporte | Windows Server 2008 |
| Plataforma de Destino | Windows |
| Cabeçalho | chstring.h (inclua FwCommon.h) |
| Biblioteca | FrameDyn.lib |
| DLL | FrameDynOS.dll; FrameDyn.dll |