comment pragma
Inserisce un record di commento in un file oggetto o in un file eseguibile.
Sintassi
#pragma comment(comment-type [,"comment-string" ])
Osservazioni:
Il tipo di commento è uno degli identificatori predefiniti, descritti di seguito, che specifica il tipo di record di commento. La stringa di commento facoltativa è un valore letterale stringa che fornisce informazioni aggiuntive per alcuni tipi di commento. Poiché la stringa di commento è un valore letterale stringa, rispetta tutte le regole per i valori letterali stringa sull'uso di 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 specifica un parametro di stringa di commento per questo tipo di record, il compilatore genera un avviso.
lib
Inserisce un record di ricerca nella libreria nel file oggetto. Questo tipo di commento deve essere accompagnato da un parametro di stringa di commento con il nome (ed eventualmente il percorso) della libreria che si desidera che il linker esequisi la ricerca. Il nome della libreria segue i record di ricerca di libreria predefiniti nel file oggetto. Il linker cerca questa libreria allo stesso modo di se è stato specificato nella riga di comando, purché la libreria non venga specificata tramite /nodefaultlib. È possibile inserire più record di ricerca nella libreria nello stesso file di origine. Ogni record viene visualizzato nel file oggetto nello stesso ordine in cui viene trovato nel file di origine.
Se l'ordine della libreria predefinita e una libreria aggiunta è importante, la compilazione con l'opzione /Zl impedirà l'inserimento del nome predefinito della libreria nel modulo oggetto. È quindi possibile usare un secondo commento pragma per inserire il nome della libreria predefinita dopo la libreria aggiunta. Le librerie elencate con queste pragma direttive verranno visualizzate nel modulo dell'oggetto nello stesso ordine in cui si trovano nel codice sorgente.
linker
Inserisce un'opzione del linker nel file oggetto. È possibile utilizzare questo tipo di commento per specificare un'opzione del linker anziché passarla alla riga di comando o specificarla nell'ambiente di sviluppo. È possibile ad esempio specificare l'opzione /include per imporre l'inclusione di un simbolo:
#pragma comment(linker, "/include:__mySymbol")
Sono disponibili solo le seguenti opzioni del linker (tipo di commento) da passare all'identificatore del linker:
utente
Inserisce un commento generale nel file oggetto. Il parametro comment-string contiene il testo del commento. Questo record di commento viene ignorato dal linker.
Esempi
Di seguito pragma viene eseguita la ricerca dell'EMAPI da parte del linker. Libreria LIB durante il collegamento. Il linker cerca prima nella directory di lavoro corrente e quindi nel percorso specificato nella variabile di ambiente LIB.
#pragma comment( lib, "emapi" )
Di seguito è possibile pragma che il compilatore inserisca il nome e il numero di versione del compilatore nel file oggetto:
#pragma comment( compiler )
Per i commenti che accettano un parametro di stringa di commento, è possibile utilizzare una macro in qualsiasi posizione in cui si utilizza un valore letterale stringa, purché la macro si espandi in un valore letterale stringa. È inoltre possibile concatenare qualsiasi combinazione di valori letterali stringa e di macro che si espandono a valori letterali stringa. L'istruzione seguente è ad esempio accettabile:
#pragma comment( user, "Compiled on " __DATE__ " at " __TIME__ )