Использование универсальных текстовых сопоставлений
Блок, относящийся только к системам Майкрософт
Чтобы упростить написание кода для разных международных рынков, в библиотеке времени выполнения Microsoft имеются специфичные для Microsoft "универсальные текстовые" сопоставления для многих типов данных, подпрограмм и других объектов. Эти сопоставления определяются в TCHAR.H. Данные сопоставления имен можно использовать для написания универсального кода, который можно компилировать в любом из трех типов наборов символов (ASCII (однобайтовая кодировка), многобайтовая кодировка или Юникод), в зависимости от константы манифеста, указанной с помощью оператора #define. Универсальные текстовые сопоставления — это расширения Майкрософт, несовместимые с ANSI.
Директивы препроцессора для сопоставлений универсального текста
#define |
Скомпилированная версия | Пример |
|---|---|---|
_UNICODE |
Юникод (расширенные символы) | _tcsrev соответствует _wcsrev |
_MBCS |
Многобайтовые символы | _tcsrev соответствует _mbsrev |
Нет (значение по умолчанию: оба _UNICODE и _MBCS не определено) |
Однобайтовая кодировка (ASCII) | _tcsrev соответствует strrev |
Например, определенная в файле TCHAR.H универсальная текстовая функция _tcsrev сопоставляется с функцией mbsrev, если в программе определена константа MBCS, или с функцией _wcsrev, если определена константа _UNICODE. В противном случае _tcsrev сопоставляется с strrev.
Универсальный текстовый тип данных _TCHAR, также определенный в TCHAR.H, сопоставляется типу char, если определена константа _MBCS, типу wchar_t, если определена константа _UNICODE, и типу char, если ни одна из констант не определена. Для удобства в файле TCHAR.H также предусмотрены другие сопоставления типов данных, однако _TCHAR является наиболее полезным типом.
Сопоставления типов данных универсального текста
| Имя универсального текстового типа данных | Однобайтовая кодировка (_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 (преобразует следующий символ или строку в аналог в Юникоде) |
Полный список универсальных текстовых сопоставлений подпрограмм, переменных и других объектов см . в сопоставлениях универсального текста.
В следующих примерах кода показано использование функций _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);
Эти макросы позволяют создавать, поддерживать и компилировать один файл исходного кода с помощью подпрограмм, относящихся ко всем трем типам наборов символов.
Завершение блока, относящегося только к системам Майкрософт
См. также
Сопоставления универсального текста
Сопоставления типов данных
Сопоставления констант и глобальных переменных
Сопоставления подпрограмм
Пример универсальной текстовой программы