Controlling the Inlining of Procedures

To specify the types of procedures to be inlined, use the /inline options. Also, compile multiple source files together and specify an adequate optimization level, such as /optimize:4.

If you omit /noinline and the /inline options, the optimization level /optimize option used determines the types of procedures that are inlined.

The /inline options are as follows:

• /inline:none (same as /noinline)

  Inlines statement functions but not other procedures. This type of inlining occurs if you specify /optimize:0 or /optimize:1 and omit /inline options.

• /inline:manual

  Inlines statement functions but not other procedures. This type of inlining occurs if you specify /optimize:2 or /optimize:3 and omit /inline options.

• /inline:size

  In addition to inlining statement functions, inlines any procedures that the Visual Fortran optimizer expects will improve run-time performance with no likely significant increase in program size.

• /inline:speed

  In addition to inlining statement functions, inlines any procedures that the Visual Fortran optimizer expects will improve run-time performance with a likely significant increase in program size. This type of inlining occurs if you specify /optimize:4 or /optimize:5 and omit /inline options.

• /inline:all

  Inlines every call that can possibly be inlined while generating correct code, including the following:

  • Statement functions (always inlined)
  • Any procedures that Visual Fortran expects will improve run-time performance with a likely significant increase in program size.
  • Any other procedures that can possibly be inlined and generate correct code. Certain recursive routines are not inlined to prevent infinite expansion.

For information on the inlining of other procedures (inlined at optimization level /optimize:4 or higher), see Inlining Procedures.

Maximizing the types of procedures that are inlined usually improves run-time performance, but compile-time memory usage and the size of the executable program may increase.

To determine whether using /inline:all benefits your particular program, time program execution for the same program compiled with and without /inline:all.