ATL 7.0 には、いくつかの新しい変換クラスと変換マクロが用意されており、既存のマクロよりも機能が大幅に向上しています。

新しい文字列変換のクラスとマクロの名前の形式は次のとおりです。

CSourceType2[C]DestinationType[EX]

指定項目 :

• SourceType と DestinationType は、以下の表で説明しています。

• [C] は、変換先の型を定数にする必要があるときに設定されます。

• [EX] は、バッファの初期サイズをテンプレート引数として指定する必要があるときに設定されます。

  変換元の型/変換先の型	説明
  A	ANSI 文字列です。
  W	Unicode 文字列です。
  T	汎用文字列です。_UNICODE が定義されている場合は W と等価です。それ以外の場合は A と等価です。
  OLE	OLE 文字列です。W と等価です。

たとえば、変換される文字列を変更せずに Unicode 文字列を汎用文字列に変換するには、CW2CT を使用します。

変換される文字列が 64 文字を超えないことが明らかな場合は、CW2CTEX<64> などの EX バージョンを使用してスタックの領域を節約できます。

メモ :
BSTR 文字列との変換には、CComBSTR クラスを使用することをお勧めします。BSTR に変換するには、既存の文字列を CComBSTR のコンストラクタに渡します。BSTR から変換するには、COLE2T などの COLE2[C]DestinationType[EX] を使用します。

バッファ (CA2AEX、CA2WEX、CW2AEX、および CW2WEX) を必要とする新しい変換クラスでは、固定サイズの静的バッファを使用して変換結果を格納します。結果のサイズが大きすぎて静的バッファに格納できない場合、クラスは malloc を使用してメモリを割り当て、オブジェクトがスコープ外に出たときにメモリを解放します。このため、以前の形式のテキスト変換マクロとは異なり、これらのクラスはループ内で安全に使用でき、スタック オーバーフローが発生しません。

ATL 7.0 で導入された変換マクロは、入力の NULL 文字列を認識するように最適化されています。これらのマクロは、入力パラメータが NULL である場合、メモリを割り当てることなく NULL を返します。

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

セキュリティに関するメモ :
マクロに文字列を渡す前に、文字列の長さをチェックして、発生する可能性のあるバッファ オーバーランを回避します。try/except でキャッチされる可能性のある例外には、スタック オーバーフローもあります。

以前の形式の文字列変換マクロと新しい文字列変換クラスには、以下のようないくつかの重要な違いがあります。

//Example 1
// Convert LPCWSTR to LPCSTR.
void ExampleFunctionW( LPCWSTR pszW )
{
   // Create an instance of CW2A, called pszA,
   // and initialize it with pszW.
   CW2A pszA( pszW );
   // pszA works like an LPCSTR, and can be used thus:
   ExampleFunctionA( pszA );  
   // Note: pszA will become invalid when it goes out of scope.
}

// Example 2
// Use a temporary instance of CW2A.
void ExampleFunctionW( LPCWSTR pszW )
{
   // Create a temporary instance of CW2A,
   // and initialize it with pszW.
   ExampleFunctionA( CW2A( pszW ) );
   // Note: the temporary instance becomes invalid 
   // after the execution of the statement above.
}

// Example 3
// Incorrect use of conversion macros.
void ExampleFunctionW( LPCWSTR pszW )
{
   // Create a temporary instance of CW2A,
   // save a pointer to it and then delete
   // the temportary instance.
   LPCSTR pszA = CW2A( pszW );
   // The pszA in the following line is an invalid pointer,
   // as the instance of CW2A has gone out of scope.
   ExampleFunctionA( pszA );
}

一時クラスのインスタンスに関する警告

LPCTSTR szr = CA2T( szReplaceFile );

LPCTSTR szr = A2T( szReplaceFile );

LPCTSTR szr = CA2T( szReplaceFile );

LPCTSTR szr;
{
   CA2T temp( szReplaceFile );
   szr = temp.operator LPTSTR();
}

CA2T szr( szReplaceFile );

高度な使用方法

// Example 4
// Changing the size of the buffer.
void ExampleFunctionW( LPCWSTR pszW )
{
   // Use a 16-character buffer.
   ExampleFunctionA( CW2CAEX< 16 >( pszW ) );
}

// Example 5
// Specifying the code page.
void ExampleFunctionW( LPCWSTR pszW )
{
   // Convert to the Macintosh code page
   ExampleFunctionA( CW2A( pszW, CP_MACCP ) );
}

以前の形式のテキスト変換マクロも使用できます。これらのマクロを次の表に示します。

これらのマクロを使用するための構文は、次のとおりです。

MACRONAME( string_address )

次に例を示します。

A2W( lpa )

マクロ名では、変換元の文字列型を左側 (この例では A)、変換先の文字列型を右側 (この例では W) に指定します。A は LPTSTR、OLE は LPOLESTR、T は LPTSTR、W は LPWSTR をそれぞれ表します。

マクロ名に C を含めた場合は、const 文字列に変換されます。たとえば、W2CA と指定した場合は、LPWSTR が LPCSTR に変換されます。

したがって、A2W と指定した場合は LPSTR が LPWSTR に変換され、OLE2T と指定した場合は LPOLESTR が LPTSTR に変換されます。

ATL 文字列変換マクロの動作は、有効になっているコンパイラ ディレクティブによって異なります。変換元と変換先の型が同じ場合、変換は行われません。コンパイラ ディレクティブでは、T および OLE を次のように変換します。

変換先の文字列は、変換先の型が BSTR である場合を除き、_alloca を使用して作成されます。_alloca を使用するとスタックからメモリを割り当てるため、関数が制御を返すとき、自動的にメモリが解放されます。既定では、このマクロは一度に最大 500 KB しか変換できません。

ATL 文字列変換マクロを使用するときは、コンパイラ エラーを避けるため、関数の先頭に USES_CONVERSION マクロを指定してください。次に例を示します。

void func( LPSTR lpsz )
{
   USES_CONVERSION;
   ...
   LPWSTR x = A2W(lpsz)
   // Do something with x
   ...
}

必要条件

関連項目

その他の技術情報