/Ob (Inline Function Expansion)
The new home for Visual Studio documentation is Visual Studio 2017 Documentation on docs.microsoft.com.
The latest version of this topic can be found at -Ob (Inline Function Expansion).
Controls inline expansion of functions.
Syntax
/Ob{0|1|2}
Arguments
0
Disables inline expansions. By default, expansion occurs at the compiler's discretion on all functions, often referred to as auto-inlining.
1
Allows expansion only of functions marked inline, __inline, or __forceinline, or in a C++ member function defined in a class declaration.
2
The default value. Allows expansion of functions marked as inline
, __inline
, or __forceinline
, and any other function that the compiler chooses.
/Ob2 is in effect when /O1, /O2 (Minimize Size, Maximize Speed) or /Ox (Full Optimization) is used.
This option requires that you enable optimizations using /O1, /O2, /Ox, or /Og.
Remarks
The compiler treats the inline expansion options and keywords as suggestions. There is no guarantee that any function will be expanded inline. You can disable inline expansions, but you cannot force the compiler to inline a particular function, even when using the __forceinline
keyword.
You can use the #pragma
auto_inline directive to exclude functions from consideration as candidates for inline expansion. Also see the #pragma
intrinsic directive.
Note
Information that is gathered from profiling test runs overrides optimizations that would otherwise be in effect if you specify /Ob, /Os, or /Ot. For more information, see Profile-Guided Optimizations.
To set this compiler option in the Visual Studio development environment
Open the project's Property Pages dialog box. For details, see Working with Project Properties.
Expand Configuration Properties, C/C++, and select Optimization.
Modify the Inline Function Expansion property.
To set this compiler option programmatically
See Also
/O Options (Optimize Code)
Compiler Options
Setting Compiler Options