DB2 Everyplace ユニコード・サポート

ユニコードをサポートするオペレーティング・システム (Windows CE、Symbian OS、Windows NT、および Windows 2000) の場合、 DB2 Everyplace は入出力ストリングとしてのみユニコード・ストリングを使用します。これらのユニコード・ストリングは、DB2 Everyplace エンジンの内部では UTF-8 形式で保管されます。ユニコード文字は、UTF-8 変換を行った後は、1 文字につき 1 から 3 バイトのストレージ・スペースが必要になります。IBM DB2 Universal Database などのデータベース・サーバーに保管された文字ストリングは、ダウンロードして Windows CE デバイス上の DB2 Everyplace に保管すると、元より大きなスペースが必要になる場合があります。

CLI ユニコード・インターフェースの注:

DB2 Everyplace CLI UNICODE 関数は、終わりに「W」の文字が付加されています。マクロ UNICODE (これは Windows CE でのシステム・デフォルトです) を定義することによって、通常の CLI 関数が、対応する UNICODE 関数に自動的にマップされます。移植可能なコードを作成するためには、マクロ「UNICODE」を定義して、システムによる変換を実行してください。
ユニコード・サポートが使用可能になると、データ・タイプ SQL_C_CHAR、SQL_C_TCHAR、および SQL_C_WCHAR は同じ意味になります。
多くの CLI 関数は、ストリング (または、バッファー) の長さを入出力パラメーターとして持っています。
- 引き数タイプ が SQLCHAR* (または、W 関数では SQLWCHAR*) である関数の場合、長さは文字数です。例えば次の場合、
```
SQLRETURN   SQLExecDirect    (SQLHSTMT          hstmt,
                              SQLCHAR     FAR   *szSqlStr,
                              SQLINTEGER        cbSqlStr);
 
```
  ユニコード・ストリング L"ABCD" は 4 文字です。
- 引き数タイプ が SQLPOINTER である関数の場合、長さはバイト数です。例えば次の場合、
```
SQLRETURN  SQLGetData       (SQLHSTMT          hstmt,
                             SQLUSMALLINT      icol,
                             SQLSMALLINT       fCType,
                             SQLPOINTER        rgbValue,
                             SQLINTEGER        cbValueMax,
                             SQLINTEGER  FAR   *pcbValue);
```
  入力パラメーター cbValueMax および出力パラメーター *pcbValue の長さは、バイトで示します。ユニコード・ストリング L"ABCD" は 8 バイトです。
UNICODE 関数では、ヌル終了ストリングを示すために SQL_NTS も使用できます。

移植可能なコードを作成するためのヒントを、以下に挙げます。

SQLCHAR または SQLWCHAR の代わりに、SQLTCHAR を使用します。
strXXXX (ANSI) または wcsXXXX (UNICODE) の代わりに、_tcsXXXX 関数を使用します。例えば、wcslen() または strlen() の代わりに、_tcslen() を使用します。
リテラル・ストリングの折り返しには、_TEXT() (または、TEXT()) を使用します。例えば、_TEXT("ABCD") は、マクロ定義によって ANSI またはユニコードのいずれかのストリングとして解釈できます。
文字配列のサイズを検出するには、sizeof(ArrayName)/sizeof(TCHAR) を使用します。

例については、DB2 Everyplace に組み込まれている「Windows CE SampleCLP のサンプル・コード」を参照してください。

関連した解説