CW2AEX クラス

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

更新 : 2007 年 11 月

このクラスは、文字列変換マクロ CT2AEX、CW2TEX、CW2CTEX、CT2CAEX、および typedef CW2A で使用されます。

template<
   int t_nBufferLength = 128
>
class CW2AEX

パラメータ

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

解説

機能を拡張しない場合、コードでは CT2AEX、CW2TEX、CW2CTEX、CT2CAEX、または CW2A を使用してください。

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

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

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

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