Important Notice

The pages on this site contain documentation for very old MS-DOS software, purely for historical purposes. If you're looking for up-to-date documentation, particularly for programming, you should not rely on the information found here, as it will be woefully out of date.

                                             ◄Up► ◄Contents► ◄Index► ◄Back►
─────LINK───────────────────────────────────────────────────────────────────
 
     A packaged function is visible to the linker in the form of a
     COMDAT record in the object file.
 
     To compile a C function as a packaged function:
 
        ■ On the CL command line, use the /Gy option.
          See: ◄CL /Gy Option►
 
        ■ In PWB, choose Enable Function Level Linking in the
          Additional Global Options dialog box, which is available from
          the C or C++ Compiler Options dialog boxes.
 
     In a C++ program, member functions are automatically packaged.
 
     Packaged functions have the following uses:
 
        ■ If a packaged function is defined but not called, LINK
          automatically removes the definition from the executable
          file. You can use /NOPACKF to preserve the definition.
          See: ◄/NOPACKF Option►
 
        ■ Packaged functions can be placed in a specified order in the
          executable file by using a FUNCTIONS statement.
          See: ◄FUNCTIONS Statement►
 
        ■ Individual packaged functions can be assigned to a specifed
          segment by using FUNCTIONS.
 
        ■ A packaged function can be placed into an overlay by using
          the FUNCTIONS statement.
          See: ◄Creating Overlaid DOS Programs►
 
     A packaged function in a C++ module sometimes must be referred to
     by its decorated name.
     See: ◄Decorated Names►
                                    -♦-