comment (C/C++)
Inserisce un record di commento in un file oggetto o in un file eseguibile.
#pragma comment( comment-type [,"commentstring"] )
Note
commento-tipo è uno degli identificatori predefiniti, descritto di seguito, che specifica il tipo di record di commento.L'elemento facoltativo commentstring è un valore letterale stringa che fornisce informazioni aggiuntive per alcuni tipi di commento.Poiché commentstring è un valore letterale stringa, obbedisce a tutte le regole per i valori letterali stringa per i caratteri di escape, virgolette incorporate (“) e concatenazione.
compilatore
Inserisce il nome e il numero di versione del compilatore nel file oggetto.Questo record di commento viene ignorato dal linker.Se si fornisce un oggetto commentstring il parametro per questo tipo di record, il compilatore genera un avviso.exestr
Posizioni commentstring nel file oggetto.In fase di collegamento questa stringa viene inserita nel file eseguibile.La stringa non viene caricata in memoria quando il file eseguibile viene caricato, tuttavia, è possibile trovare con un programma che cerca le stringhe stampabili nei file.Un utilizzo di questo tipo di commento-record prevede l'inclusione di un numero di versione o le informazioni simili in un file eseguibile.exestr è stato deprecato e sarà rimosso nelle versioni future, il linker non elabora il record di commento.
lib
Inserisce un record di raccolta-ricerca nel file oggetto.Questo tipo di commento deve essere seguito da commentstring parametro che contiene il nome ed eventualmente il percorso) della raccolta che si desidera che il linker per trovare.Il nome della libreria seguito i record predefiniti di raccolta-ricerca nel file oggetto; il linker individua questa raccolta come se fosse stata denominata nella riga di comando a condizione che la raccolta non viene specificata con /nodefaultlib.È possibile inserire più record di raccolta-ricerca nello stesso file di origine; ogni record viene visualizzato nel file oggetto nello stesso ordine in cui viene rilevato nel file di origine.Se l'ordine di raccolta predefinita e una libreria aggiunta è importante, la compilazione con /Zl l'opzione se il nome di libreria predefinito venga inserito nel modulo di oggetto.Un secondo pragma comment quindi può essere utilizzato per inserire il nome della raccolta predefinita dopo la libreria aggiunta.Le librerie elencate con i pragma visualizzati nel modulo di oggetto nello stesso ordine in cui vengono trovate nel codice sorgente.
linker
Inserisce un oggetto opzione del linker nel file oggetto.È possibile utilizzare questo commento-tipo per specificare un'opzione del linker anziché la riga di comando o di specificarla nell'ambiente di sviluppo.Ad esempio, è possibile specificare l'opzione /include per imporre l'inclusione di un simbolo:#pragma comment(linker, "/include:__mySymbol")Solo di seguito (commento-tipo) le opzioni del linker sono disponibili per essere passato all'identificatore del linker:
utente
Inserisce un commento generale nel file oggetto.commentstring il parametro è contenuto il testo del commento.Questo record di commento viene ignorato dal linker.
Il seguente pragma indica al linker di trovare la raccolta di EMAPI.LIB mentre è collegato.Le ricerche del linker in primo luogo nella cartella di lavoro corrente e quindi nel percorso specificato nella variabile di ambiente LIB.
#pragma comment( lib, "emapi" )
Il seguente pragma indica al compilatore di inserire il nome e il numero di versione del compilatore nel file oggetto:
#pragma comment( compiler )
[!NOTA]
Per i commenti che accettano un oggetto commentstring parametro, è possibile utilizzare una macro in qualsiasi punto in cui si utilizzerebbe un valore letterale stringa, purché la macro si espande a un valore letterale stringa.È inoltre possibile concatenare qualsiasi combinazione di valori letterali stringa e di macro che si espandono i valori letterali stringa.Ad esempio, la seguente istruzione è accettabile:
#pragma comment( user, "Compiled on " __DATE__ " at " __TIME__ )