asc_create_mask

产 品 支 持 情 况

产 品	是 否 支 持
Ascend 950PR/Ascend 950DT	√

功 能 说 明

根 据 入 参 生 成 相 应 的 掩 码 寄 存 器。生 成 的 掩 码 用 于 约 束RegTensor的 计 算 范 围，将 掩 码 作 为 参 数 传 入 其 他 函 数，则 只 有 掩 码 为True所 对 应 的 元 素 才 会 参 与 计 算。

函 数 原 型

C++

asc_create_mask_b8(pat_mode)
asc_create_mask_b16(pat_mode)
asc_create_mask_b32(pat_mode)

参 数 说 明

参 数 名	输 入/输 出	描 述
pat_mode	输 入	掩 码 寄 存 器 的 创 建 模 式，pat_mode表 示 选 取 元 素 的 范 围，定 义 如 下： PAT_ALL, // 所 有 元 素 都 参 与 计 算 PAT_VL1, // 最 低 位 的1个 元 素 PAT_VL2, // 最 低 位 的2个 元 素 PAT_VL3, // 最 低 位 的3个 元 素 PAT_VL4, // 最 低 位 的4个 元 素 PAT_VL8, // 最 低 位 的8个 元 素 PAT_VL16, // 最 低 位 的16个 元 素 PAT_VL32, // 最 低 位 的32个 元 素 PAT_VL64, // 最 低 位 的64个 元 素 PAT_VL128, // 最 低 位 的128个 元 素 PAT_M3, // 下 标 为3的 倍 数 的 元 素 PAT_M4, // 下 标 为4的 倍 数 的 元 素 PAT_H, // 低 一 半 的 元 素 PAT_Q, // 低 四 分 之 一 的 元 素 PAT_ALLF = 15 // 任 何 元 素 都 不 参 与 计 算

返 回 值 说 明

根 据 上 述 提 供 的 模 式 生 成 相 应 的 掩 码 寄 存 器，数 据 类 型 为vector_bool，其 位 宽 固 定 为VL/8。如 果 是 调 用 asc_create_mask_b8生 成 的 掩 码，返 回 值 中 一 个bit位 置 对 应 一 个 元 素；如 果 生 成 的 是 非b8类 型 的 掩 码，则 返 回 值 中N（N=数 据 位 宽/8）个bit对 应 一 个 元 素，只 有 低 比 特 位 有 效。

流 水 类 型

PIPE_V

约 束 说 明

无

调 用 示 例

见掩 码 寄 存 器 调 用 示 例。