Classe CW2WEX
Essa classe é usada pelas macros de conversão de cadeia de caracteres CW2TEX e CT2WEX, e pelo typedef CW2W.
Importante
Essa classe e os respectivos membros não podem ser usados em aplicativos executados no Windows Runtime.
Sintaxe
template <int t_nBufferLength = 128>
class CW2WEX
Parâmetros
t_nBufferLength
O tamanho do buffer usado no processo de tradução. O comprimento padrão é de 128 bytes.
Membros
Construtores públicos
| Nome | Descrição |
|---|---|
| CW2WEX::CW2WEX | O construtor . |
| CW2WEX::~CW2WEX | O destruidor. |
Operadores públicos
| Nome | Descrição |
|---|---|
| CW2WEX::operator LPWSTR | Operador de conversão. |
Membros de Dados Públicos
| Nome | Descrição |
|---|---|
| CW2WEX::m_psz | O membro de dados que armazena a cadeia de caracteres fonte. |
| CW2WEX::m_szBuffer | O buffer estático, usado para armazenar a cadeia de caracteres convertida. |
Comentários
A menos que seja necessária uma funcionalidade adicional, use CW2TEX, CT2WEX ou CW2W 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 for muito grande para caber no buffer estático, a classe aloca memória usando malloc, liberando a memória quando o objeto sair do escopo. Isso vai garantir que, ao contrário das macros de conversão de texto disponíveis em versões anteriores da ATL, essa classe será segura para usar em loops e não causará estouro da pilha.
Se a classe tentar alocar memória no heap e falhar, ela chamará AtlThrow com um argumento de E_OUTOFMEMORY.
Por padrão, as macros e classes de conversão da ATL usam a página de código ANSI dos threads atuais para a conversão.
As seguintes macros são baseadas nessa classe:
CW2TEX
CT2WEX
O seguinte typedef baseia-se nessa classe:
- CW2W
Para ver uma discussão sobre essas macros de conversão de texto, confira Macros de conversão de cadeia de caracteres da ATL e MFC.
Exemplo
Confira Macros de conversão de cadeia de caracteres da ATL e MFC para obter um exemplo de como usar essas macros de conversão de cadeia de caracteres.
Requisitos
Cabeçalho: atlconv.h
CW2WEX::CW2WEX
O construtor .
CW2WEX(LPCWSTR psz, UINT nCodePage) throw(...);
CW2WEX( LPCWSTR psz) throw(...);
Parâmetros
psz
A cadeia de caracteres de texto a ser convertida.
nCodePage
A página de código. Não usado nessa classe.
Comentários
Cria o buffer necessário para a tradução.
CW2WEX::~CW2WEX
O destruidor.
~CW2WEX() throw();
Comentários
Libera o buffer alocado.
CW2WEX::m_psz
O membro de dados que armazena a cadeia de caracteres fonte.
LPWSTR m_psz;
CW2WEX::m_szBuffer
O buffer estático, usado para armazenar a cadeia de caracteres convertida.
wchar_t m_szBuffer[t_nBufferLength];
CW2WEX::operator LPWSTR
Operador cast.
operator LPWSTR() const throw();
Valor de retorno
Retorna a cadeia de caracteres de texto como tipo LPWSTR.
Confira também
Classe CA2AEX
Classe CA2CAEX
Classe CA2WEX
Classe CW2AEX
Classe CW2CWEX
Visão geral da aula