Description de décoration de nom C++

Traductions disponibles Traductions disponibles
Numéro d'article: 126845 - Voir les produits auxquels s'applique cet article
Agrandir tout | Réduire tout

Sommaire

Résumé

Les compilateurs C++ de Microsoft codent les noms de symboles dans les programmes C++ pour inclure des informations de type dans le nom. Ceci est appelé «décoration de nom» ou «composition des noms». L'objectif de ce consiste à garantir la liaison de type sécurisé. Le langage C++ permet la surcharge de fonction où les fonctions avec le même nom sont uniquement distinguées un autre par les types de données des arguments aux fonctions. La décoration de nom permet à l'éditeur de liens faire la distinction entre les différentes versions de fonctions surchargées dans la mesure où les noms des fonctions sont codées ou décorés différemment.

Plus d'informations

Fournisseurs de compilateurs différents ont leurs propres méthodes ou les algorithmes pour la décoration de noms. Microsoft ne publie pas l'algorithme que son compilateurs utilisent pour la décoration des noms car il peut changer à l'avenir. Toutefois, il est parfois nécessaire obtenir la version d'un nom de fonction décorée. Par exemple, vous devrez peut-être exporter une fonction C++ à partir d'une DLL de Windows en les répertoriant dans la section EXPORTS d'un fichier .def permet de générer la DLL. (Bien que la déclaration de que fonction avec __declspec (dllexport) est la méthode recommandée pour exporter une fonction C++ à l'aide de Visual C++, Édition 32 bits, il est toujours valide à utiliser un fichier .def avec ces produits). Pour exporter la fonction correctement, vous devez répertorier ses nom décoré, pas le nom dans le code source.

Pour tous les produits répertoriés ci-dessus, Microsoft propose à outils du navigateur. Ces kits de ressources fournissent des fonctions qui peuvent interpréter les noms décorés.

Pour plus d'informations sur __declspec (dllexport), cliquez sur le numéro ci-dessous pour afficher l'article correspondant dans la base de connaissances Microsoft :
132044Dans le code à l'aide de _declspec (dllimport) et _declspec(dllexport)
L'exemple de code suivant utilise la fonction FormatDName dans la bibliothèque de navigateur, une partie de la Browser Toolkit. Pour télécharger la trousse à outils du navigateur, reportez-vous au site Web de Microsoft à l'adresse suivante :
http://www.microsoft.com/downloads/details.aspx?FamilyID=621ae185-1c2a-4d6b-8146-183d66fe709d&displaylang=en
La fonction renvoie la forme non décorée du nom lui est passé.

Exemple de code

   /* Compile options needed: cl /AL getname.cpp bthunkl.obj /link bsc.lib
          (for 16-bit, where getname.cpp is the source file name)
                              cl getname.cpp /link bsc.lib
          (for 32-bit version 4.x and earlier, where getname.cpp is the source
           file name)
   */ 

   #include <iostream.h>
   #include <strstrea.h>

   extern "C"
   {
   #include "hungary.h"
   #include "bsc.h"
   #include "bscsup.h"
   }

   void main( int argc, char *argv[] )
   {
       if ( argc < 2 )
       {
           cout << "Usage: GETNAME decorated-name" << endl;
           return;
       }

       strstream name;

       // Call browser library function to get undecorated name
       name << FormatDname ( argv[1] ) << '\0';

       cout << "Undecorated name: " << name.str() << endl;
       name.rdbuf()->freeze( 0 );
   }
				
L'exemple suivant fonctionne avec la plus récente navigateur Toolkit 5.0 et Visual C++ version 5.0.
   /* Compile options needed: cl /GX getname.cpp /link msbsc50.lib
          (where getname.cpp is the source file name)
   */ 

   #include <iostream>
   #include <strstream>
   #include <windows.h>
   #include "bsc.h"

   using namespace std;

   int main( int argc, char *argv[] )
   {
       Bsc* pbsc;

       if ( argc < 3 )
       {
           cout << "Usage: GETNAME bscfile-name decorated-name" << endl;
           return 1;
       }

       strstream name;

       // Open the browser file
       Bsc::open( argv[1], &pbsc );

       // Call browser library function to get undecorated name
       name << pbsc->formatDname( argv[2] ) << '\0';

       cout << "Undecorated name: " << name.str() << endl;
       name.rdbuf()->freeze( 0 );

       pbsc->close();
       return 0;
   }
				

Propriétés

Numéro d'article: 126845 - Dernière mise à jour: jeudi 1 septembre 2005 - Version: 4.0
Les informations contenues dans cet article s'appliquent au(x) produit(s) suivant(s):
  • Microsoft Visual C++ 1.5 Édition Professionnelle
  • Microsoft Visual C++ 1.51
  • Microsoft Visual C++ 1.52 Édition Professionnelle
  • Microsoft Visual C++ 2.0 Édition Professionnelle
  • Microsoft Visual C++ 2.1
  • Microsoft Visual C++ 4.0 Édition Standard
  • Microsoft Visual C++ 4.1 Subscription
  • Microsoft Visual C++ 5.0 Édition Entreprise
  • Microsoft Visual C++ 6.0 Édition Entreprise
  • Microsoft Visual C++ 5.0 Édition Professionnelle
  • Microsoft Visual C++ 6.0 Édition Professionnelle
  • Microsoft Visual C++, 32-bit Learning Edition 6.0
Mots-clés : 
kbmt kbcode kbcompiler kbcpponly kbinfo KB126845 KbMtfr
Traduction automatique
IMPORTANT : Cet article est issu du système de traduction automatique mis au point par Microsoft (http://support.microsoft.com/gp/mtdetails). Un certain nombre d?articles obtenus par traduction automatique sont en effet mis à votre disposition en complément des articles traduits en langue française par des traducteurs professionnels. Cela vous permet d?avoir accès, dans votre propre langue, à l?ensemble des articles de la base de connaissances rédigés originellement en langue anglaise. Les articles traduits automatiquement ne sont pas toujours parfaits et peuvent comporter des erreurs de vocabulaire, de syntaxe ou de grammaire (probablement semblables aux erreurs que ferait une personne étrangère s?exprimant dans votre langue !). Néanmoins, mis à part ces imperfections, ces articles devraient suffire à vous orienter et à vous aider à résoudre votre problème. Microsoft s?efforce aussi continuellement de faire évoluer son système de traduction automatique.
La version anglaise de cet article est la suivante: 126845
L'INFORMATION CONTENUE DANS CE DOCUMENT EST FOURNIE PAR MICROSOFT SANS GARANTIE D'AUCUNE SORTE, EXPLICITE OU IMPLICITE. L'UTILISATEUR ASSUME LE RISQUE DE L'UTILISATION DU CONTENU DE CE DOCUMENT. CE DOCUMENT NE PEUT ETRE REVENDU OU CEDE EN ECHANGE D'UN QUELCONQUE PROFIT.

Envoyer des commentaires

 

Contact us for more help

Contact us for more help
Connect with Answer Desk for expert help.
Get more support from smallbusiness.support.microsoft.com