Utilisation de types de données TCHAR.H avec _MBCS

Mise à jour : novembre 2007

Lorsque la constante de manifeste _MBCS est définie, une routine de texte générique donnée correspond à l'un des types de routines suivants :

• Une routine SBCS qui gère les octets, les caractères et les chaînes multioctets comme il convient. Dans ce cas, les arguments de chaîne doivent être de type char*. Par exemple, _tprintf correspond à printf; les arguments de chaîne de printf sont de types char*. Si vous utilisez le type de données de texte générique _TCHAR pour vos types de chaînes, les types de paramètres formels et actuels pour printf correspondent car _TCHAR* correspond à char*.

• Une routine spécifique à MBCS. Dans ce cas, les arguments de chaîne doivent être de type unsigned char*. Par exemple, _tcsrev correspond à _mbsrev, qui attend et retourne une chaîne de type unsignedchar*. Si vous utilisez le type de données de texte générique _TCHAR pour vos types de chaînes, il peut se produire un conflit de type car _TCHAR correspond au type char.

Vous trouverez ci-dessous trois solutions pour empêcher ce conflit de type (et les avertissements du compilateur C ou les erreurs du compilateur C++ qui peuvent en résulter).

• Utilisez le comportement par défaut. Tchar.h fournit des prototypes de routine de texte générique pour les routines dans les bibliothèques runtime, comme indiqué dans l'exemple suivant.

  char * _tcsrev(char *);
  

  Dans le cas par défaut, le prototype pour _tcsrev correspond à _mbsrev par l'intermédiaire d'un thunk dans Libc.lib. Cela transforme les types de paramètres entrants et de valeurs de retour sortantes _mbsrev de _TCHAR* (c'est-à-dire char *) en unsigned char *. Cette méthode permet la mise en correspondance des types lorsque vous utilisez _TCHAR, mais est lente en raison du temps de gestion nécessaire à l'appel de fonction.

• Utilisez la fonction inline en incorporant l'instruction du préprocesseur suivante dans votre code.

  #define _USE_INLINING
  

  Cette méthode provoque un thunk de fonction inline, par Tchar.h, permettant de mapper directement la routine de texte générique à la routine MBCS appropriée. L'extrait de code suivant de Tchar.h fournit un exemple de cette méthode.

  __inline char *_tcsrev(char *_s1)
  {return (char *)_mbsrev((unsigned char *)_s1);}
  

  La meilleure solution est d'utiliser une fonction inline, car elle garantit la mise en correspondance des types sans coût horaire supplémentaire.

• Utilisez le mappage direct en incorporant l'instruction du préprocesseur suivante dans votre code.

  #define _MB_MAP_DIRECT
  

  Cette solution est appréciable si vous ne souhaitez pas utiliser le comportement par défaut ou ne pouvez pas utiliser la fonction inline. Cette solution permet le mappage de la routine de texte générique par une macro directement en version MBCS de la routine, comme dans l'exemple suivant de Tchar.h.

  #define _tcschr _mbschr
  

  Lorsque vous utilisez cette solution, vous devez utiliser les types de données appropriés pour les arguments de chaîne et les valeurs retournées de chaîne. Vous pouvez utiliser la conversion de type forcée pour assurer une correspondance de type correcte ou vous pouvez utiliser le type de données de texte générique _TXCHAR. _TXCHAR correspond au type char dans le code SBCS mais correspond au type unsigned char dans le code MBCS. Pour plus d'informations sur les macros de texte générique, consultez Mappages de texte générique dans la référence de la bibliothèque runtime.

Voir aussi

Concepts

Mappages de texte générique dans Tchar.h