nanf

产品支持情况

  • Ascend 950PR/Ascend 950DT:支持
  • Atlas A3 训练系列产品/Atlas A3 推理系列产品:不支持
  • Atlas A2 训练系列产品/Atlas A2 推理系列产品:不支持
  • Atlas 200I/500 A2 推理产品:不支持
  • Atlas 推理系列产品AI Core:不支持
  • Atlas 推理系列产品Vector Core:不支持
  • Atlas 训练系列产品:不支持

功能说明

根据输入的字符串生成一个float类型的安静NaN值(浮点尾数最高位为1),并将tagp解析值的低22位写入该NaN值的低22位。

函数原型

inline float nanf(const char* tagp)

参数说明

表1 参数说明

参数名 输入/输出 描述
tagp 输入 源操作字符串首地址。支持十进制、八进制和十六进制格式;字符串无法按支持的进制解析时按0处理。

返回值说明

返回float类型的安静NaN值。返回值的低22位为tagp解析值的低22位;tagp字符串无法按支持的进制解析时,低22位为0;tagp解析溢出时,低22位为全1。

约束说明

需要包含的头文件

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

#include "simt_api/math_functions.h"

调用示例

  • SIMT编程场景:

    __global__ __launch_bounds__(1024) void kernel_nanf(float* dst)
    {
        dst[0] = nanf("0x1A");
        dst[1] = nanf("123");
        dst[2] = nanf("abc");
        dst[3] = nanf("0");
    }
    
  • SIMD与SIMT混合编程场景:

    __simt_vf__ __launch_bounds__(1024) inline void kernel_nanf(__gm__ float* dst)
    {
        dst[0] = nanf("0x1A");
        dst[1] = nanf("123");
        dst[2] = nanf("abc");
        dst[3] = nanf("0");
    }
    

输入输出示例如下:

tagp:"0x1A", "123", "abc", "0"
result: nan(0x7fc0001a) nan(0x7fc0007b) nan(0x7fc00000) nan(0x7fc00000)