CA2WEX クラス

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

このクラスは、文字列変換マクロ CA2TEX、CA2CTEX、CT2WEX、CT2CWEX、および typedef CA2W で使用されます。

template<
   int t_nBufferLength = 128
>
class CA2WEX

パラメータ

t_nBufferLength
変換プロセスで使用するバッファのサイズ。既定の長さは 128 バイトです。

解説

機能を拡張しない場合、コードでは CA2TEX、CA2CTEX、CT2WEX、CT2CWEX、または CA2W を使用してください。

このクラスには、変換結果を格納するための、固定サイズの静的バッファが設定されています。結果のサイズが大きすぎて静的バッファに格納できない場合、クラスは malloc を使用してメモリを割り当て、オブジェクトがスコープ外に出たときにメモリを解放します。このため、以前のバージョンの ATL で使用されていたテキスト変換マクロとは異なり、このクラスをループで使用しても安全です。また、スタックをオーバーフローすることもありません。

クラスがヒープメモリの割り当てに失敗した場合、クラスは引数 E_OUTOFMEMORY を指定して AtlThrow を呼び出します。

既定では、ATL の変換クラスおよびマクロは、現在のスレッドの ANSI コードページを使用して変換を行います。特定の変換のためにこの動作をオーバーライドする場合は、クラスのコンストラクタの 2 番目のパラメータとしてコードページを指定します。

次の各マクロは、このクラスに基づいています。