diff -r 4891d49809bb -r 2b3996fc09a1 core/com.nokia.carbide.cpp.compiler.doc.user/html/pragmas/p_inline_bottom_up.htm --- a/core/com.nokia.carbide.cpp.compiler.doc.user/html/pragmas/p_inline_bottom_up.htm Mon Jul 19 15:31:48 2010 -0500 +++ b/core/com.nokia.carbide.cpp.compiler.doc.user/html/pragmas/p_inline_bottom_up.htm Mon Jul 19 16:13:24 2010 -0500 @@ -1,40 +1,40 @@ - - - - - - - inline_bottom_up - - - - -

inline_bottom_up

-

Controls the bottom-up function inlining method.

-
Syntax
-

#pragma inline_bottom_up on | off | reset -

-
Targets
- All platforms.
-
Remarks
-

Bottom-up function inlining tries to expand up to eight levels of inline leaf functions. The maximum size of an expanded inline function and the caller of an inline function can be controlled by the pragmas shown in Listing 10.23 and Listing 10.24.

-
-

Listing 10.23 Maximum Complexity of an Inlined Function

-

// maximum complexity of an inlined function
- #pragma inline_max_size( max ) // default max == 256

-
-
-

Listing 10.24 Maximum Complexity of a Function that Calls Inlined Functions

-

// maximum complexity of a function that calls inlined functions
- #pragma inline_max_total_size( max ) // default max == 10000

-
-

where max loosely corresponds to the number of instructions in a function.

-

If you enable this pragma, the compiler calculates inline depth from the last function in the call chain up to the first function that starts the call chain. The number of functions the compiler inlines from the bottom depends on the values of inline_depth, inline_max_size, and inline_max_total_size. This method generates faster and smaller source code for some (but not all) programs with many nested inline function calls.

-

If you disable this pragma, top-down inlining is selected, and the inline_depth setting determines the limits for top-down inlining.

-

The pragmas inline_max_size and inline_max_total_size do not affect the compiler in top-down mode.

-

This pragma corresponds to the Bottom-up Inline setting . To check this setting, use __option (inline_bottom_up), described in Checking Settings. The default setting is off.

- - - - - + + + + + + + inline_bottom_up + + + + +

inline_bottom_up

+

Controls the bottom-up function inlining method.

+
Syntax
+

#pragma inline_bottom_up on | off | reset +

+
Targets
+ All platforms.
+
Remarks
+

Bottom-up function inlining tries to expand up to eight levels of inline leaf functions. The maximum size of an expanded inline function and the caller of an inline function can be controlled by the pragmas shown in Listing 10.23 and Listing 10.24.

+
+

Listing 10.23 Maximum Complexity of an Inlined Function

+

// maximum complexity of an inlined function
+ #pragma inline_max_size( max ) // default max == 256

+
+
+

Listing 10.24 Maximum Complexity of a Function that Calls Inlined Functions

+

// maximum complexity of a function that calls inlined functions
+ #pragma inline_max_total_size( max ) // default max == 10000

+
+

where max loosely corresponds to the number of instructions in a function.

+

If you enable this pragma, the compiler calculates inline depth from the last function in the call chain up to the first function that starts the call chain. The number of functions the compiler inlines from the bottom depends on the values of inline_depth, inline_max_size, and inline_max_total_size. This method generates faster and smaller source code for some (but not all) programs with many nested inline function calls.

+

If you disable this pragma, top-down inlining is selected, and the inline_depth setting determines the limits for top-down inlining.

+

The pragmas inline_max_size and inline_max_total_size do not affect the compiler in top-down mode.

+

This pragma corresponds to the Bottom-up Inline setting . To check this setting, use __option (inline_bottom_up), described in Checking Settings. The default setting is off.

+ + + + +