Verwenden von Zuordnungen für generischen Text

Microsoft-spezifisch

Um die Codeentwicklung für internationale Märkte zu vereinfachen, stellt die Microsoft-Laufzeitbibliothek für viele Datentypen, Routinen und andere Objekte Microsoft-spezifische Zuordnungen für generischen Text zur Verfügung. Diese Zuordnungen werden in TCHAR.H definiert. Sie können mithilfe dieser Namenszuordnungen generischen Code schreiben, der für die folgenden drei Arten von Zeichensätzen kompiliert werden kann: ASCII (SBCS), MBCS oder Unicode. Dies hängt von der Manifestkonstante ab, die Sie mit einer #define-Anweisung definieren. Generische Textzuordnungen sind Microsoft-Erweiterungen, die nicht ANSI-kompatibel sind.

Präprozessordirektiven für generische Textzuordnungen

#define	Kompilierte Version	Beispiel
_UNICODE	Unicode (Breitzeichen)	_tcsrev ist _wcsrev zugeordnet.
_MBCS	Mehrbytezeichen	_tcsrev ist _mbsrev zugeordnet.
Keine (Standard: beide _UNICODE und _MBCS nicht definiert)	SBCS (ASCII)	_tcsrev ist strrev zugeordnet.

Die in TCHAR.H definierte generische Textfunktion _tcsrev wird der mbsrev-Funktion zugeordnet, wenn MBCS in Ihrem Programm definiert wurde, oder sie wird _wcsrev zugeordnet, wenn _UNICODE definiert wurde. Andernfalls wird _tcsrevstrrev zugeordnet.

Der generische Text vom Datentyp _TCHAR, der auch in TCHAR.H definiert ist, wird dem Typ char zugeordnet, wenn _MBCS definiert ist; dem Typ wchar_t, wenn _UNICODE definiert ist; und dem Typ char, wenn keine Konstante definiert ist. Zur Vereinfachung der Programmierung werden in TCHAR.H weitere Datentypzuordnungen zur Verfügung gestellt; _TCHAR ist jedoch die hilfreichste Zuordnung.

Generische Textzuordnungen von Datentypen

Datentypname für generischen Text	SBCS (_UNICODE & MBCS nicht definiert)	_MBCS definiert	_UNICODE definiert
_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 oder _TEXT	Ohne Auswirkung (wird vom Präprozessor entfernt)	Ohne Auswirkung (wird vom Präprozessor entfernt)	L (konvertiert das nächste Zeichen oder die nächste Zeichenfolge in die Unicode-Entsprechung)

Eine vollständige Liste der generischen Textzuordnungen von Routinen, Variablen und anderen Objekten finden Sie unter Generic-Text-Zuordnungen.

Aus den folgenden Codefragmenten geht hervor, wie _TCHAR und _tcsrev für die Zuordnung zu den MBCS-, Unicode- und SBCS-Modellen verwendet werden.

_TCHAR *RetVal, *szString;
RetVal = _tcsrev(szString);

Wenn MBCS definiert wurde, ordnet der Präprozessor dem vorangehenden Fragment folgenden Code zu:

char *RetVal, *szString;
RetVal = _mbsrev(szString);

Wenn _UNICODE definiert wurde, ordnet der Präprozessor diesem Fragment folgenden Code zu:

wchar_t *RetVal, *szString;
RetVal = _wcsrev(szString);

Wenn beide _MBCS nicht definiert wurden _UNICODE , ordnet der Präprozessor das Fragment wie folgt einem ASCII-Code mit einem Byte zu:

char *RetVal, *szString;
RetVal = strrev(szString);

Mit diesen Makros können Sie schreiben, Standard beibehalten und eine einzelne Quellcodedatei mithilfe von Routinen kompilieren, die für alle drei Arten von Zeichensätzen spezifisch sind.

Ende Microsoft-spezifisch

Siehe auch

Generische Textzuordnungen
Datentypzuordnungen
Konstanten- und globalen Variablenzuordnungen
Routine-Zuordnungen
Beispiel für ein generisches Textprogramm