Utilisation des mappages de texte générique

Section spécifique à Microsoft

Pour simplifier le développement de code pour les marchés internationaux, la bibliothèque Runtime Microsoft fournit des mappages de « texte générique » spécifiques à Microsoft pour de nombreux types de données, routines et autres objets. Ces mappages sont définis dans TCHAR.H. Vous pouvez utiliser ces mappages de nom pour écrire du code générique qui peut être compilé pour n’importe lequel des trois types de jeux de caractères : ASCII (SBCS), MBCS ou Unicode, en fonction d’une constante manifeste que vous définissez à l’aide d’une instruction #define. Les mappages de texte générique sont des extensions Microsoft qui ne sont pas compatibles ANSI.

Directives de préprocesseur pour les mappages de texte générique

#define	Version compilée	Exemple
_UNICODE	Unicode (caractères larges)	_tcsrev est mappé à _wcsrev
_MBCS	Caractères multioctets	_tcsrev est mappé à _mbsrev
Aucun (valeur par défaut : à la fois _UNICODE et _MBCS non défini)	SBCS (ASCII)	_tcsrev est mappé à strrev

Par exemple, la fonction de texte générique _tcsrev, définie dans TChar.h, est mappée à mbsrev si MBCS a été défini dans votre programme, ou à _wcsrev si _UNICODE a été défini. Sinon, _tcsrev est mappée à strrev.

Le type de données texte générique _TCHAR, également défini dans TCHAR.H, correspond au type char si _MBCS est défini, au type wchar_t si _UNICODE est défini et au type char si aucune constante n’est définie. Les autres mappages de type de données sont fournis dans TCHAR.H pour faciliter la programmation, mais _TCHAR est le type le plus utile.

Mappages de types de données de texte générique

Nom de type de données de texte générique	SBCS (_UNICODE, _MBCS non définis)	_MBCS défini	_UNICODE défini
_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 ou _TEXT	Aucun effet (supprimé par le préprocesseur)	Aucun effet (supprimé par le préprocesseur)	L (convertit le caractère suivant ou la chaîne suivante en son équivalent Unicode)

Pour obtenir la liste complète des mappages de texte générique de routines, de variables et d’autres objets, consultez mappages de texte générique.

Les fragments de code suivants illustrent l’utilisation de _TCHAR et _tcsrev pour le mappage sur les modèles MBCS, Unicode et SBCS.

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

Si MBCS a été défini, le préprocesseur mappe le fragment précédent sur le code suivant :

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

Si _UNICODE a été défini, le préprocesseur mappe le même fragment sur le code suivant :

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

Si les deux _MBCS et _UNICODE n’ont pas été définis, le préprocesseur mappe le fragment au code ASCII à un octet, comme suit :

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

Ces macros vous permettent d’écrire, de gérer et de compiler un fichier de code source unique à l’aide de routines spécifiques aux trois types de jeux de caractères.

FIN de la section spécifique à Microsoft

Voir aussi

Mappages de texte générique
Mappages de types de données
Mappages de variables constantes et globales
Mappages de routine
Exemple de programme de texte générique