You need to enable JavaScript to run this app. 如何为Numba函数定义多签名以兼容标量与数组类型的输入输出
优惠活动
大模型
产品
解决方案
定价
更多

如何为Numba函数定义多签名以兼容标量与数组类型的输入输出

Numba 多类型入参/返回值配置方案

Numba 可通过给@numba.njit传入多签名列表的方式实现对标量、数组两类入参的同时支持,运行时会根据实际传入的参数类型自动匹配对应的编译重载版本,无需额外实现类似Union的泛型逻辑。

具体配置方法

将cosd对应的装饰器修改为多签名传参形式即可:

import numpy as np
import numba
from numba import float64

# 传入两类匹配的签名组成的列表
@numba.njit([
    float64(float64),    # 匹配标量入参:输入64位浮点标量,返回同类型标量
    float64[:](float64[:]) # 匹配一维数组入参:输入64位浮点一维数组,返回同维度同类型数组
])
def cosd(angle):
    return np.cos(np.radians(angle))

关键规则说明

  • 配置完成后,cosd可直接接收标量类型的angle参数返回标量结果,也可接收一维浮点数组类型的angle参数返回同维度数组结果,主函数内的调用逻辑不需要做任何修改。
  • 若后续需要支持更高维度的数组入参,只需要在签名列表中追加对应规则即可,例如需要支持二维数组就追加float64[:,:](float64[:,:])到列表中。
  • 如果不想手动枚举所有需要支持的数组维度,也可以直接使用无显式签名的@numba.njit(即装饰器不附加任何签名参数),Numba会在第一次遇到对应类型的入参时自动完成JIT编译,支持任意维度的浮点数组和标量输入,缺点是首次匹配新类型时会产生一定的编译延迟。
  • 这种多签名重载机制和Numba内部的函数调用逻辑完全兼容,在被其他@njit装饰的主函数内部调用时,不会出现类型匹配错误的问题。

内容的提问来源于stack exchange,提问作者mauro

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.03 10:15:03