ILE C/C++ Compiler Reference
Allows the compiler to consider replacing a function call with the called
function's instructions. Inlining a function eliminates the
overhead of a call and can result in better optimization. Small
functions that are called many times are good candidates for inlining.
- Note:
- When specifying an INLINE option, all preceding INLINE options must also be
specified, including their defaults.
|--+---------------------------------------------------------------+--|
'-INLINE(--+-----------------------------------------------+--)-'
| .-*OFF-. |
'-+-*ON--+--+---------------------------------+-'
| .-*NOAUTO-. |
'-+-*AUTO---+--| INLINE Details |-'
INLINE Details (continued):
|--+----------------------------------------------+-------------|
| .-250------. |
'-+-1-65535--+--+----------------------------+-'
'-*NOLIMIT-' | .-2000-----. |
'-+-1-65535--+--+----------+-'
'-*NOLIMIT-' | .-*NO--. |
'-+-*YES-+-'
The possible INLINE options are:
- Inliner
- Specifies whether or not inlining is to be used.
- *OFF
- Default setting. Specifies that inlining will not be performed on
the compilation unit.
- *ON
- Specifies that inlining will be performed on the compilation unit.
If a debug listing view is specified, the inliner is turned off.
- Mode
- Specifies whether or not the inliner should attempt to automatically
inline functions depending on their Threshold and Limit.
- *NOAUTO
- Specifies that only the functions that have been specified with the
#pragma inline directive should be considered candidates for inlining.
This is a default.
- *AUTO
- Specifies that the inliner should determine if a function can be inlined
based on the specified Threshold and Limit. The #pragma noinline
directive overrides *AUTO.
- Threshold
- Specifies the maximum size of a function that can be a candidate for
automatic inlining. The size is measured in Abstract Code Units.
Abstract Code Units are proportional in size to the executable code in the
function; C and C++ code is translated into Abstract Code Units by the
compiler.
- 250
- Specifies a threshold of 250. This is the default.
- 1-65535
- Specifies a threshold from 1 to 65535.
- *NOLIMIT
- Defines the threshold as the maximum size of the program.
- Limit
- Specifies the maximum relative size a function can grow before
auto-inlining stops.
- 2000
- Specifies a limit of 2000. This is the default.
- 1-65535
- Specifies a limit from 1 to 65535.
- *NOLIMIT
- Limit is defined as the maximum size of the program. System limits
may be encountered.
- Report
- Specifies whether or not to produce an inliner report with the compiler
listing.
- *NO
- The inliner report is not produced. This is the default.
- *YES
- The inliner report is produced. OUTPUT(*PRINT) must be
specified to produce the inliner report.
[ Top of Page | Previous Page | Next Page | Table of Contents ]
(C) Copyright IBM Corporation 1992, 2006. All Rights Reserved.