DB2 Everyplace UNICODE 支持

在支持 UNICODE 的操作系统（Windows CE、Symbian OS、Windows NT 和 Windows 2000）上，DB2 Everyplace 只使用 UNICODE 字符串作为输入／输出字符串。这些 UNICODE 字符串以 UTF-8 格式保存在 DB2 Everyplace 引擎内。UNICODE 字符在经过 UTF-8 转换后可能需要 1 到 3 个字节的存储空间。如果存储在数据库服务器（如 IBM DB2 通用数据库）中的字符串是下载的且存储在 Windows CE 设备上的 DB2 Everyplace 中，则该字符串可能需要更多的空间。

CLI UNICODE 接口注意事项：

DB2 Everyplace CLI UNICODE 函数在末尾追加有字符“W”。通过定义宏 UNICODE（在 Windows CE 上这是系统缺省值），常规 CLI 函数会自动映射到相应的 UNICODE 函数。要编写可移植代码，定义宏“UNICODE”并让系统执行转换。
当启用 UNICODE 支持时，数据类型 SQL_C_CHAR、SQL_C_TCHAR 和 SQL_C_WCHAR 具有相同的含义。

许多 CLI 函数将字符串（或缓冲区）长度用作输入／输出参数。

对于自变量类型为 SQLCHAR*（对于 W 函数，为 SQLWCHAR*）的函数，长度为字符数。例如：

SQLRETURN   SQLExecDirect    (SQLHSTMT          hstmt,
                              SQLCHAR     FAR   *szSqlStr,
                              SQLINTEGER        cbSqlStr);

UNICODE 字符串 L"ABCD" 是四个字符。

对于自变量类型为 SQLPOINTER 的函数，长度为字节数。例如：

SQLRETURN  SQLGetData       (SQLHSTMT          hstmt,
                             SQLUSMALLINT      icol,
                             SQLSMALLINT       fCType,
                             SQLPOINTER        rgbValue,
                             SQLINTEGER        cbValueMax,
                             SQLINTEGER  FAR   *pcbValue);

输入参数 cbValueMax 和输出参数 *pcbValue 的长度都是以字节计的。UNICODE 字符串 L"ABCD" 是八个字节。

UNICODE 函数还会采用 SQL_NTS 来表示以空结束的字符串。

编写可移植代码的技巧：

使用 SQLTCHAR 而不是 SQLCHAR 或 SQLWCHAR。
使用 _tcsXXXX 函数而不是 strXXXX（ANSI）或 wcsXXXX（UNICODE）。例如，使用 _tcslen() 而不是 wcslen() 或 strlen()。
使用 _TEXT()（或 TEXT()）来将文字串括起来。例如，根据宏定义，_TEXT("ABCD") 可解释为 ANSI 或 UNICODE 字符串。
使用 sizeof(ArrayName)/sizeof(TCHAR) 来查明字符数组的大小。

有关示例，请参阅 DB2 Everyplace 附带包括的 Windows CE SampleCLP 样本代码。

相关参考