CA2WEX Class

Artigo
02/25/2013

Essa classe é usada por CA2TEXmacros, CA2CTEX, CT2WEX, e CT2CWEX, e o typedef CA2Wde conversão de cadeia de caracteres.

Importante
Essa classe e seus membros não podem ser usados em aplicativos executados em tempo de execução do windows.

template<
int t_nBufferLength= 128
>
class CA2WEX

Parâmetros

t_nBufferLength
O tamanho do buffer usado no processo de conversão.o comprimento padrão é 128 bytes.

Membros

Construtores public

Nome	Descrição
CA2WEX::CA2WEX	o construtor.
CA2WEX::~CA2WEX	O destrutor.

Operadores públicos

Nome	Descrição
CA2WEX::operator LPWSTR	Operador de conversão.

Membros públicos de dados

Nome	Descrição
CA2WEX::m_psz	O membro de dados que armazena a cadeia de caracteres de origem.
CA2WEX::m_szBuffer	o buffer estático, usado para armazenar a cadeia de caracteres convertida.

Comentários

A menos que a funcionalidade adicional é necessária, use CA2TEX, CA2CTEX, CT2WEX, CT2CWEX, ou CA2W no seu código.

Essa classe contém um buffer estático de tamanho fixo que é usado para armazenar o resultado da conversão.Se o resultado é muito grande caber no buffer estático, a classe aloca memória usando malloc, liberando memória quando o objeto sai do escopo.Isso garante que, ao invés de macros de conversão de texto disponíveis nas versões anteriores de ATL, essa classe é seguro para usar em loop e que não transbordará a pilha.

Se a classe tenta atribuir a memória na heap e falhar, chamará AtlThrow com um argumento de E_OUTOFMEMORY.

Por padrão, as classes de conversão de ATL e macros usam a página de código ANSI atual da thread para a conversão.Se você deseja substituir esse comportamento para uma conversão específica, especifique a página de código como o segundo parâmetro para o construtor para a classe.

Os seguintes macros são baseados em essa classe: