GetSaturationStrategy

产品支持情况

• Ascend 950PR/Ascend 950DT：支持

• Atlas A3 训练系列产品/Atlas A3 推理系列产品：不支持

• Atlas A2 训练系列产品/Atlas A2 推理系列产品：不支持

• Atlas 200I/500 A2 推理产品：不支持

• Atlas 推理系列产品AI Core：不支持

• Atlas 推理系列产品Vector Core：不支持

• Atlas 训练系列产品：不支持

• Kirin X90：不支持

• Kirin 9030：不支持

功能说明

头文件路径为："basic_api/kernel_operator_common_intf.h"。

获取精度转换接口当前使用的饱和模式配置策略。饱和模式用于处理精度转换过程中结果溢出或出现INF/NAN的场景，详细说明请参考SetSaturationFlag功能说明。该接口用于查询通过SetSaturationStrategy选择的配置来源，主要与Memory矢量计算的Cast和Reg矢量计算的Cast配合使用：

• 使用接口自身的饱和配置时，Reg矢量计算Cast通过CastTrait::satMode配置单接口的饱和或非饱和模式；Memory矢量计算Cast不提供单接口饱和模式参数，其单接口配置为饱和模式。
• 使用全局饱和配置时，两类Cast均使用SetSaturationFlag设置的全局饱和模式。

函数原型

__aicore__ inline OverrideStrategy GetSaturationStrategy()

参数说明

无

返回值说明

返回值类型为OverrideStrategy，表示当前使用的饱和模式配置策略。

表1 返回值说明

返回值	描述
OverrideStrategy::USE_API	使用精度转换接口自身的饱和配置。
OverrideStrategy::USE_GLOBAL	使用SetSaturationFlag设置的全局饱和配置，系统默认采用该策略。

约束说明

无

调用示例

如下示例中查询当前是否使用SetSaturationFlag设置的全局饱和模式。

bool useGlobal = AscendC::GetSaturationStrategy() == AscendC::OverrideStrategy::USE_GLOBAL;