Bagikan melalui

Kelas CA2WEX

  • Artikel

Kelas ini digunakan oleh makro konversi string CA2TEX, CA2CTEX, CT2WEX, dan CT2CWEX, dan typedef CA2W.

Penting

Kelas ini dan anggotanya tidak dapat digunakan dalam aplikasi yang dijalankan di Windows Runtime.

Sintaks

template <int t_nBufferLength = 128>
class CA2WEX

Parameter

t_nBufferLength
Ukuran buffer yang digunakan dalam proses terjemahan. Panjang defaultnya adalah 128 byte.

Anggota

Konstruktor Publik

Nama Deskripsi
CA2WEX::CA2WEX Konstruktor.
CA2WEX::~CA2WEX Destruktor.

Operator Publik

Nama Deskripsi
CA2WEX::operator LPWSTR Operator konversi.

Anggota Data Publik

Nama Deskripsi
CA2WEX::m_psz Anggota data yang menyimpan string sumber.
CA2WEX::m_szBuffer Buffer statis, digunakan untuk menyimpan string yang dikonversi.

Keterangan

Kecuali fungsionalitas tambahan diperlukan, gunakan CA2TEX, CA2CTEX, CT2WEX, CT2CWEX, atau CA2W dalam kode Anda.

Kelas ini berisi buffer statis ukuran tetap yang digunakan untuk menyimpan hasil konversi. Jika hasilnya terlalu besar untuk masuk ke dalam buffer statis, kelas mengalokasikan memori menggunakan malloc, membebaskan memori ketika objek keluar dari cakupan. Ini memastikan bahwa, tidak seperti makro konversi teks yang tersedia di versi ATL sebelumnya, kelas ini aman digunakan dalam perulangan dan tidak akan meluapkan tumpukan.

Jika kelas mencoba mengalokasikan memori pada tumpukan dan gagal, kelas akan memanggil AtlThrow dengan argumen E_OUTOFMEMORY.

Secara default, kelas konversi ATL dan makro menggunakan halaman kode ANSI utas saat ini untuk konversi. Jika Anda ingin mengambil alih perilaku tersebut untuk konversi tertentu, tentukan halaman kode sebagai parameter kedua ke konstruktor untuk kelas tersebut.

Makro berikut didasarkan pada kelas ini:

  • CA2TEX

  • CA2CTEX

  • CT2WEX

  • CT2CWEX

Typedef berikut didasarkan pada kelas ini:

  • CA2W

Untuk diskusi makro konversi teks ini, lihat Makro Konversi String ATL dan MFC.

Contoh

Lihat Makro Konversi String ATL dan MFC untuk contoh penggunaan makro konversi string ini.

Persyaratan

Header: atlconv.h

CA2WEX::CA2WEX

Konstruktor.

CA2WEX(LPCSTR psz, UINT nCodePage) throw(...);
CA2WEX(LPCSTR psz) throw(...);

Parameter

psz
String teks yang akan dikonversi.

nCodePage
Halaman kode yang digunakan untuk melakukan konversi. Lihat diskusi parameter halaman kode untuk fungsi Windows SDK MultiByteToWideChar untuk detail selengkapnya.

Keterangan

Mengalokasikan buffer yang digunakan dalam proses terjemahan.

CA2WEX::~CA2WEX

Destruktor.

~CA2WEX() throw();

Keterangan

Membebaskan buffer yang dialokasikan.

CA2WEX::m_psz

Anggota data yang menyimpan string sumber.

LPWSTR m_psz;

CA2WEX::m_szBuffer

Buffer statis, digunakan untuk menyimpan string yang dikonversi.

wchar_t m_szBuffer[t_nBufferLength];

CA2WEX::operator LPWSTR

Operator konversi.

operator LPWSTR() const throw();

Tampilkan Nilai

Mengembalikan string teks sebagai jenis LPWSTR.

Lihat juga

Kelas CA2AEX
Kelas CA2CAEX
Kelas CW2AEX
Kelas CW2CWEX
Kelas CW2WEX
Gambaran Umum Kelas