米6体育平台手机版

ZHCUAQ1F july 2015 – april 2023

4.5 自动内联扩展（--auto_inline 选项）

当使用 --opt_level=3 选项（别名为 -O3）进行优化时，编译器自动内联小函数。命令行选项 --auto_inline=size 指定自动内联的大小阈值。此选项仅控制未明确声明为内联的函数的内联。

当未使用 --auto_inline 选项时，编译器根据优化级别和优化目标（性能与代码大小）设置大小限制。如果 -auto_inline size 参数设置为 0，则禁用自动内联扩展。如果 --auto_inline size 参数设置为非零整数，则编译器自动内联任何小于 size 的函数。（这是对以前版本的更改；以前的版本会内联那些函数大小与函数调用次数的乘积小于size 的函数。新方案更简单，但通常会对给定的 size 值进行更多的内联。）

编译器以任意单位测量函数的大小；但是，优化器信息文件（使用 --gen_opt_info=1 或 --gen_opt_info=2 选项创建）报告 --auto_inline 选项使用的相同单位中每个函数的大小。当使用 --auto_inline 时，编译器不会试图阻止导致编译时间或大小过度增长的内联；故请小心使用。

当未使用 --auto_inline 选项时，在特定调用点内联函数的决策是基于试图优化效益和成本的算法。编译器在调用点内联符合条件的函数，直至达到有关大小或编译时间的限制。

内联行为因指定的编译时选项而异：

如果编译的是代码大小而非性能时，则代码大小限制较小。--auto_inline 选项覆盖此大小限制。
在 --opt_level=3 时，编译器自动内联小函数。

有关影响内联的命令行选项、pragma 和关键字之间的交互信息，请参阅节 3.11。

注： 有些函数不能被内联：如要考虑内联调用点，内联函数必须是合法的，并且不得以某种方式禁用内联。请参阅节 3.11.2中的内联限制。

注： 优化级别 3 和内联：为了打开自动内联，必须使用 --opt_level=3 选项。如果需要 --opt_level=3 优化，但不想自动内联，请使用 --auto_inline=0 和 --opt_level=3 选项。

注： 内联和代码大小：内联扩展函数会增加代码大小，尤其是内联在多个地方被调用的函数。对于仅在少数地方被调用的函数以及小函数来说，函数内联是最优的。为了防止由于内联而增加代码大小，请使用 --auto_inline=0 选项。此选项使编译器仅内联内在函数。