Classe CW2WEX
Esta classe é usada pelas macros de conversão de cadeia de caracteres CW2TEX e CT2WEX, e o typedef CW2W.
Importante
Essa classe e seus membros não podem ser usados em aplicativos executados no Tempo de Execução do Windows.
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
| Designação | Descrição |
|---|---|
| CW2WEX::CW2WEX | O construtor. |
| CW2WEX::~CW2WEX | O destruidor. |
Operadores Públicos
| Designação | Descrição |
|---|---|
| CW2WEX::operador LPWSTR | Operador de conversão. |
Membros de Dados Públicos
| Designação | Descrição |
|---|---|
| CW2WEX::m_psz | O membro de dados que armazena a cadeia de caracteres de origem. |
| CW2WEX::m_szBuffer | O buffer estático, usado para armazenar a cadeia de caracteres convertida. |
Comentários
A menos que seja necessária funcionalidade extra, use CW2TEX, CT2WEX ou CW2W em 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 sai do escopo. Isso garante que, ao contrário das macros de conversão de texto disponíveis em versões anteriores do ATL, essa classe seja segura para uso em loops e não transborde a pilha.
Se a classe tentar alocar memória na pilha e falhar, ela chamará AtlThrow com um argumento de E_OUTOFMEMORY.
Por padrão, as classes de conversão ATL e macros usam a página de código ANSI do thread atual para a conversão.
As macros a seguir são baseadas nessa classe:
CW2TEX
CT2WEX
O typedef a seguir é baseado nessa classe:
- CW2W
Para obter uma discussão sobre essas macros de conversão de texto, consulte Macros de conversão de cadeia de caracteres ATL e MFC.
Exemplo
Consulte de conversão de cadeia de caracteres ATL e MFC para obter um exemplo de como usar essas macros de conversão de cadeia de caracteres.
Requerimentos
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 utilizado nesta 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 de origem.
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::operador LPWSTR
Operador de elenco.
operator LPWSTR() const throw();
Valor de retorno
Retorna a cadeia de caracteres de texto como tipo LPWSTR.
Ver também
CA2AEX Classe
CA2CAEX Classe
CA2WEX Classe
CW2AEX Classe
CW2CWEX Classe
Visão geral da classe