comment pragma

  • Article

Place un enregistrement de commentaires dans un fichier objet ou un fichier exécutable.

Syntaxe

#pragma comment(comment-type [ , « comment-string » ] )

Notes

Le type de commentaire est l’un des identificateurs prédéfinis, décrits ci-dessous, qui spécifie le type d’enregistrement de commentaire. La chaîne de commentaire facultative est un littéral de chaîne qui fournit des informations supplémentaires pour certains types de commentaires. Étant donné que la chaîne de commentaire est un littéral de chaîne , elle obéit à toutes les règles des littéraux de chaîne à l’utilisation de caractères d’échappement, de guillemets incorporés (") et de concaténation.

compiler

Place le nom et le numéro de version du compilateur dans le fichier objet. Cet enregistrement de commentaires est ignoré par l'Éditeur de liens. Si vous fournissez un paramètre de chaîne de commentaire pour ce type d’enregistrement, le compilateur génère un avertissement.

lib

Place un enregistrement de recherche de bibliothèque dans le fichier objet. Ce type de commentaire doit être accompagné d’un paramètre de chaîne de commentaire qui a le nom (et éventuellement le chemin) de la bibliothèque que vous souhaitez que l’éditeur de liens recherche. Le nom de la bibliothèque suit les enregistrements de recherche de bibliothèque par défaut dans le fichier objet. L’éditeur de liens recherche cette bibliothèque de la même façon que si vous l’avez spécifiée sur la ligne de commande, tant que la bibliothèque n’est pas spécifiée à l’aide /nodefaultlibde . Vous pouvez placer plusieurs enregistrements de recherche de bibliothèque dans le même fichier source. Chaque enregistrement apparaît dans le fichier objet dans le même ordre qu’il se trouve dans le fichier source.

Si l’ordre de la bibliothèque par défaut et une bibliothèque ajoutée est important, la compilation avec le /Zl commutateur empêche le nom de la bibliothèque par défaut d’être placé dans le module objet. Un deuxième commentaire pragma peut ensuite être utilisé pour insérer le nom de la bibliothèque par défaut après l’ajout de la bibliothèque. Les bibliothèques répertoriées avec ces pragma directives s’affichent dans le module objet dans le même ordre qu’elles se trouvent dans le code source.

éditeur de liens

Place une option d’éditeur de liens dans le fichier objet. Vous pouvez utiliser ce type-commentaire pour spécifier une option d'éditeur de liens au lieu de la passer à la ligne de commande ou de la spécifier 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 (type de commentaire) suivantes sont disponibles pour être transmises à l’identificateur de l’éditeur de liens :

utilisateur

Place un commentaire général dans le fichier objet. Le paramètre de chaîne de commentaire contient le texte du commentaire. Cet enregistrement de commentaires est ignoré par l'Éditeur de liens.

Exemples

pragma L’éditeur de liens recherche l’EMAPI. Bibliothèque LIB lors de la liaison. L’éditeur de liens recherche d’abord dans le répertoire de travail actif, puis dans le chemin spécifié dans la variable d’environnement LIB.

#pragma comment( lib, "emapi" )

Les causes suivantes pragma entraînent le compilateur à placer le nom et le numéro de version du compilateur dans le fichier objet :

#pragma comment( compiler )

Pour les commentaires qui prennent un paramètre de chaîne de commentaire, vous pouvez utiliser une macro à n’importe quel endroit où vous utiliseriez un littéral de chaîne, tant que la macro se développe sur un littéral de chaîne. Vous pouvez également concaténer toute combinaison de littéraux de chaîne et de macros qui se développent en littéraux de chaîne. Par exemple, l'instruction suivante est acceptable :

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

Voir aussi

Directives pragma et les __pragma_Pragma mot clé