Partager via


comment (C/C++)

place un enregistrement de commentaire dans un fichier objet ou un fichier exécutable.

#pragma comment( comment-type [,"commentstring"] )

Notes

Le commentaire-type est l'un des ID prédéfinis, décrit ci-dessous, qui spécifie le type d'enregistrement de commentaire.commentstring facultatif est un littéral de chaîne qui fournit des informations supplémentaires pour certains types de commentaire.Étant donné qu' commentstring est un littéral de chaîne, il est conforme à toutes les règles pour les littéraux de chaîne en ce qui concerne les caractères d'échappement, les guillemets incorporés (Liens Ignorer la navigation), et la concaténation.

  • compilateur
    place le nom et le numéro de version du compilateur dans le fichier objet.cet enregistrement de commentaire est ignoré par l'éditeur de liens.si vous fournissez un paramètre d' commentstring pour ce type d'enregistrement, le compilateur génère un avertissement.

  • exestr
    place commentstring dans le fichier objet.Au moment de la liaison cette chaîne est placée dans le fichier exécutable.La chaîne n'est pas chargé en mémoire lorsque le fichier exécutable est chargé ; toutefois, il se trouve à un programme qui recherche les chaînes imprimables dans les fichiers.Une utilisation de ce type de commentaire-enregistrement est d'incorporer un numéro de version ou des informations similaires dans un fichier exécutable.

    exestr est déconseillée et sera supprimé dans une version ultérieure ; l'éditeur de liens ne gère pas l'enregistrement de commentaire.

  • lib
    place un enregistrement de bibliothèque-recherche dans le fichier objet.Ce type de commentaire doit être accompagné d'un paramètre d' commentstring contenant le nom (et éventuellement le chemin d'accès) de la bibliothèque que vous voulez l'éditeur de liens pour rechercher.le nom de la bibliothèque suit les enregistrements par défaut de bibliothèque-recherche dans le fichier objet ; recherche d'éditeur de liens pour cette bibliothèque comme si vous l'aviez nommée sur la ligne de commande à condition que la bibliothèque ne soit pas spécifiée avec /nodefaultlib.Vous pouvez placer plusieurs enregistrements de bibliothèque-recherche dans le même fichier source ; chaque enregistrement apparaît dans le fichier objet dans le même ordre dans lequel il est produit dans le fichier source.

    Si la commande de bibliothèque par défaut et d'une bibliothèque ajoutée est importante, compilez avec le commutateur de /Zl empêchera le nom de bibliothèque par défaut d'être placé dans le module objet.Un deuxième pragma comment peut être utilisé pour insérer le nom de bibliothèque par défaut après la bibliothèque ajoutée.Les bibliothèques répertoriées avec ces mots s'affichent dans le module objet dans l'ordre dans lequel ils sont trouvés dans le code source.

  • éditeur de liens
    place option de l'éditeur de liens dans le fichier objet.Vous pouvez utiliser ce commentaire-type pour spécifier une option de l'éditeur de liens au lieu de la passer à la ligne de commande ou de la spécification dans l'environnement de développement.Par exemple, vous pouvez spécifier l'option /include pour forcer l'inclusion d'un symbole :

    #pragma comment(linker, "/include:__mySymbol")
    

    Seules les options de l'éditeur de liens suivantes (commentaire-type) sont disponibles pour être passées à l'identificateur de l'éditeur de liens :

  • utilisateur
    Place d'une remarque générale dans le fichier objet.Le paramètre d' commentstring contient le texte de commentaire.cet enregistrement de commentaire est ignoré par l'éditeur de liens.

Le pragma suivant entraîne l'éditeur de liens pour rechercher la bibliothèque d'EMAPI.LIB lors de la liaison.L'éditeur de liens le recherche d'abord dans le répertoire de travail actuel puis dans le chemin d'accès spécifié dans la variable d'environnement LIB.

#pragma comment( lib, "emapi" )

Le pragma suivant fait de placer le compilateur le nom et le numéro de version du compilateur dans le fichier objet :

#pragma comment( compiler )

[!REMARQUE]

Pour les commentaires qui prennent un paramètre d' commentstring , vous pouvez utiliser une macro dans tous les emplacements où vous utiliseriez un littéral de chaîne, à condition que la macro développe à un littéral de chaîne.Vous pouvez également concaténer n'importe quelle combinaison des littéraux de chaîne et des macros qui se traduit par des littéraux de chaîne.par exemple, l'instruction suivante est acceptable :

#pragma comment( user, "Compiled on " __DATE__ " at " __TIME__ ) 

Voir aussi

Référence

Directives pragma et le mot clé de __Pragma