inline_depth

指定内联启发式搜索深度,这样,如果它的深度大于 n 的深度(在调用关系图中),则函数将不内联。

#pragma inline_depth( [n] )

备注

此杂注控制标记为 inline__inline 的函数的内联或在 /Ob2 选项下自动内联。

n 可以是介于 0 和 255 之间的值,其中 255 表示调用关系图中的无限深度,而零禁止内联展开。如果不指定 n,则将使用默认值 (254)。

inline_depth 杂注控制可以展开一系列函数调用的次数。 例如,如果内联深度为 4,并且如果 A 调用 B,然后 B 调用 C,则所有三种调用将为展开的内联。 但是,如果最接近的内联展开为 2,则仅展开 A 和 B,而 C 作为函数调用保留。

若要使用此杂注,必须将 /Ob 编译器选项设置为 1 或 2。 使用该杂注的深度设置在该杂注后进行第一个函数调用时生效。

可在展开过程中减小内联深度,但不能增大该深度。 如果内联深度为 6,并且在展开期间,预处理器遇到值为 8 的 inline_depth 杂注,则深度保持为 6。

inline_depth 杂注对使用 __forceinline 标记的函数无效。

备注

可对递归函数进行内联替换,最大调用深度为 16。

请参见

参考

Pragma 指令和 __Pragma 关键字

inline_recursion