使用一般文本映射
Microsoft 专用
为了简化各种国际市场的代码开发，Microsoft 运行时库为许多数据类型、例程和其他对象提供了 Microsoft 专用的“一般文本”映射。 这些映射在 TCHAR.H 中进行定义。 可以使用这些名称映射来编写可编译全部三种字符集（ASCII (SBCS)、MBCS 或 Unicode）的通用代码：具体取决于使用 #define 语句定义的清单常量。 一般文本映射是与 ANSI 不兼容的 Microsoft 扩展。
用于一般文本映射的预处理器指令
#define |
编译的版本 | 示例 |
|---|---|---|
_UNICODE |
Unicode（宽字符） | _tcsrev 映射到 _wcsrev |
_MBCS |
多字节字符 | _tcsrev 映射到 _mbsrev |
无（默认值：_UNICODE 和 _MBCS 均未定义） |
SBCS (ASCII) | _tcsrev 映射到 strrev |
例如，如果已在程序中定义了 MBCS，则在 TCHAR.H 中定义的一般文本函数 _tcsrev 映射到 mbsrev，如果已定义了 _UNICODE，则将映射到 _wcsrev。 否则，_tcsrev 将映射到 strrev。
如果已定义了 _MBCS，则仍在 TCHAR.H 中定义的一般文本数据类型 _TCHAR 将映射到类型 char，如果定义了 _UNICODE，则映射到类型 wchar_t，如果未定义任何常量，则映射到 char。 TCHAR.H 中提供了其他数据类型映射，可方便地用于编程，但 _TCHAR 是最有用的类型。
一般文本数据类型映射
| 一般文本数据类型名称 | SBCS（未定义的 _UNICODE 和 _MBCS） | 已定义 _MBCS | 已定义 _UNICODE |
|---|---|---|---|
_TCHAR |
char |
char |
wchar_t |
_TINT |
int |
int |
wint_t |
_TSCHAR |
signed char |
signed char |
wchar_t |
_TUCHAR |
unsigned char |
unsigned char |
wchar_t |
_TXCHAR |
char |
unsigned char |
wchar_t |
_T 或 _TEXT |
无效果（由预处理器删除） | 无效果（由预处理器删除） | L（将以下字符或字符串转换为其 Unicode 对应项） |
有关例程、变量和其他对象的一般文本映射的完整列表，请参阅一般文本映射。
以下代码片段说明了用于映射到 MBCS、Unicode 和 SBCS 模型的 _TCHAR 和 _tcsrev 的使用方法。
_TCHAR *RetVal, *szString;
RetVal = _tcsrev(szString);
如果定义了 MBCS，则预处理器将前面的片段映射到以下代码：
char *RetVal, *szString;
RetVal = _mbsrev(szString);
如果定义了 _UNICODE，则预处理器将同一片段映射到以下代码：
wchar_t *RetVal, *szString;
RetVal = _wcsrev(szString);
如果 _MBCS 和 _UNICODE 均未定义，则预处理器将片段映射到单字节 ASCII 代码，如下所示：
char *RetVal, *szString;
RetVal = strrev(szString);
通过这些宏，可以使用特定于所有三种字符集的例程来编写、维护和编译单个源代码文件。
结束 Microsoft 专用