◄Up► ◄Contents► ◄Index► ◄Back►
─────C/C++ Language─────────────────────────────────────────────────────────
 
  Pragma:   comment
 
  Syntax:   #pragma comment( comment-type [, commentstring])
 
  Summary:  The comment pragma allows you to place a comment record in
            an object file or executable file.
 
     The <comment-type> specifies the type of comment record. The
     optional <commentstring> is a string literal that provides
     additional information for some comment types. Because
     <comment-type> is a string literal, it obeys all the rules for
     string literals with respect to escape characters, embedded
     quotation marks ("), and concatenation.
 
     The following comment records are allowed:
 
     Record     Description
 
     compiler   Places the name and version number of the compiler in
                the object file. This comment record is ignored by the
                linker. If you supply a <commentstring> parameter for
                this record type, the compiler generates a warning
                error message.
 
     exestr     Places <commentstring> in the object file. At link
                time, this string is placed in the executable file.
                The string is not loaded into memory when the
                executable file is loaded; however, it can be found
                with a program that finds printable strings in files.
                One use for this comment-record type is to embed a
                version number or similar information in an
                executable file.
 
     lib        Places a library-search record in the object file.
                This comment type must be accompanied by a
                <commentstring> parameter containing the name (and
                possibly the path) of the library for which you want
                the linker to search. Since the library name precedes
                the default library-search records in the object file,
                the linker searches for this library just as if you had
                named it on the command line. You can place multiple
                library-search records in the same source file; each
                record appears in the object file in the same order in
                which it is encountered in the source file.
 
     user       Places a general comment in the object file. The
                <commentstring> parameter contains the text of the
                comment. This comment record is ignored by the linker.
 
     The following pragma causes the linker to search for the
     EMAPI.LIB library. The linker searches first in the current
     working directory and then in the path specified in the LIB
     environment variable.
 
          #pragma comment( lib, "emapi" )
 
     The following pragma causes the compiler to place the name and
     version number of the compiler in the object file:
 
          #pragma comment( compiler )
 
     NOTE: For comments that take a <commentstring> parameter, you can
           use a macro in any place where you would use a string
           literal, provided that the macro expands to a string
           literal. You can also concatenate any combination of string
           literals and macros that expand to string literals. For
           example, the following statement is acceptable:
 
     #pragma comment( user, "Compiled on " __DATE__ " at " __TIME__ )
                                    -♦-