frexpf

产品支持情况

• Ascend 950PR/Ascend 950DT：支持

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

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

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

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

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

功能说明

将x转换为归一化[1/2, 1)的有符号数乘以2的积分幂。返回归一化的有符号数，指数存储在exp中。

函数原型

inline float frexpf(float x, int *exp)

参数说明

表1 参数说明

参数名	输入/输出	描述
x	输入	源操作数。
exp	输出	Unified Buffer、Global Memory或栈空间的地址，用于存储以2为底的指数。

返回值说明

将x转换为归一化[1/2, 1)的有符号数乘以2的积分幂时，返回该有符号数。

• 当x为inf时，返回值为inf，exp为0。
• 当x为-inf时，返回值为-inf，exp为0。
• 当x为nan时，返回值为nan，exp为0。

约束说明

无

需要包含的头文件

使用该接口需要包含"simt_api/math_functions.h"头文件。

#include "simt_api/math_functions.h"

调用示例

• SIMT编程场景：

  __global__ __launch_bounds__(256) void compute_frexpf(float *result, int *exp_out, const float *x, uint32_t count)
  {
      const uint32_t idx = blockIdx.x * blockDim.x + threadIdx.x;
      if (idx >= count) {
          return;
      }
      result[idx] = frexpf(x[idx], exp_out + idx);
  }
  

• SIMD与SIMT混合编程场景：

  __simt_vf__ __launch_bounds__(256) inline void compute_frexpf_vf(__gm__ float *result, __gm__ int *exp_out, __gm__ const float *x, uint32_t count)
  {
      const uint32_t idx = blockIdx.x * blockDim.x + threadIdx.x;
      if (idx >= count) {
          return;
      }
      result[idx] = frexpf(x[idx], exp_out + idx);
  }
  
  __global__ __vector__ void run_frexpf(__gm__ float *result, __gm__ int *exp_out, __gm__ const float *x, uint32_t count)
  {
      asc_vf_call<compute_frexpf_vf>(dim3(256), result, exp_out, x, count);
  }
  

输入输出示例如下：

x：0.25, 0.75, 1.25, 1.75
result: 0.5 0.75 0.625 0.875
exp_out: -1 0 1 1