Mapowania zwykłego tekstu
Specyficzne dla firmy Microsoft
Aby uprościć tworzenie kodu na różnych rynkach międzynarodowych, biblioteka czasu wykonywania firmy Microsoft udostępnia mapowania specyficzne dla firmy Microsoft "ogólny tekst" dla wielu typów danych, procedur i innych obiektów. Te mapowania są definiowane w TCHAR.H. Za pomocą tych mapowań nazw można napisać kod ogólny, który można skompilować dla dowolnego z trzech rodzajów zestawów znaków: ASCII (SBCS), MBCS lub Unicode, w zależności od stałej manifestu definiowanej #define przy użyciu instrukcji . Mapowania tekstu ogólnego to rozszerzenia firmy Microsoft, które nie są zgodne ze standardem ANSI.
Dyrektywy preprocesora dla mapowań tekstu ogólnego
#define |
Skompilowana wersja | Przykład |
|---|---|---|
_UNICODE |
Unicode (znak szeroki) | _tcsrev mapuje na _wcsrev |
_MBCS |
Znak wielobajtowy | _tcsrev mapuje na _mbsrev |
Brak (wartość domyślna: zarówno, jak _UNICODE i _MBCS nie zdefiniowana) |
SBCS (ASCII) | _tcsrev mapuje na strrev |
Na przykład funkcja generic-text zdefiniowana w TCHAR _tcsrev. H, mapuje na mbsrev to, czy MBCS został zdefiniowany w programie, lub do _wcsrev , czy _UNICODE został zdefiniowany. W przeciwnym razie _tcsrev mapuje na strrev.
Typ _TCHARdanych ogólnego tekstu , zdefiniowany również w TCHAR. H, mapuje na typ char , jeśli _MBCS jest zdefiniowany, typ wchar_t , jeśli _UNICODE jest zdefiniowany, i typ char , jeśli żadna stała nie jest zdefiniowana. Inne mapowania typów danych są dostępne w usłudze TCHAR. H dla wygody programowania, ale _TCHAR jest typem, który jest najbardziej przydatny.
Mapowania typów danych tekstu ogólnego
| Nazwa typu danych tekstu ogólnego | SBCS (_UNICODE, nie zdefiniowano _MBCS) | _MBCS zdefiniowano | _UNICODE zdefiniowano |
|---|---|---|---|
_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 lub _TEXT |
Brak efektu (usunięte przez preprocesor) | Brak efektu (usunięte przez preprocesor) | L (konwertuje następujący znak lub ciąg na jego odpowiednik Unicode) |
Aby uzyskać pełną listę mapowań tekstu ogólnego tekstu procedur, zmiennych i innych obiektów, zobacz Ogólne mapowania tekstu.
Poniższe fragmenty kodu ilustrują użycie elementów _TCHAR i _tcsrev do mapowania na modele MBCS, Unicode i SBCS.
_TCHAR *RetVal, *szString;
RetVal = _tcsrev(szString);
Jeśli MBCS został zdefiniowany, preprocesor mapuje poprzedni fragment na następujący kod:
char *RetVal, *szString;
RetVal = _mbsrev(szString);
Jeśli _UNICODE został zdefiniowany, preprocesor mapuje ten sam fragment na następujący kod:
wchar_t *RetVal, *szString;
RetVal = _wcsrev(szString);
Jeśli obie _MBCS metody i _UNICODE nie zostały zdefiniowane, preprocesor mapuje fragment na kod ASCII jedno bajtów w następujący sposób:
char *RetVal, *szString;
RetVal = strrev(szString);
Te makra umożliwiają pisanie, konserwowanie i kompilowanie pojedynczego pliku kodu źródłowego przy użyciu procedur specyficznych dla wszystkich trzech rodzajów zestawów znaków.
END Microsoft Specific
Zobacz też
Mapowania tekstu ogólnego
Mapowania typów danych
Mapowania zmiennych stałych i globalnych
Mapowania rutynowe
Przykładowy program tekstowy ogólny