0

0

如何在 NumPy 中从 Python 调用 C 函数:源码级调用机制解析

花韻仙語

花韻仙語

发布时间:2026-01-18 14:13:40

|

855人浏览过

|

来源于php中文网

原创

如何在 NumPy 中从 Python 调用 C 函数:源码级调用机制解析

numpy 通过 c 扩展模块(如 `_multiarray_umath`)将 python 接口直接绑定到底层 c 函数,调用 `np.array()` 等函数时,python 解释器会跳过字节码执行,直接动态链接并调用编译后的共享库函数。

NumPy 的高性能核心源于其大量关键操作(如数组创建、内存布局管理、基础 ufunc 计算)均由 C 语言实现。但这些 C 函数并非通过 ctypes 或 cffi 等外部桥接方式调用,而是以 原生 C 扩展模块(CPython Extension Module) 的形式深度集成进 Python 解释器——这是最高效、最标准的 Python/C 互操作机制。

核心机制:C 扩展模块注册与方法绑定

当 NumPy 安装完成,其核心模块 numpy.core._multiarray_umath 实际对应一个已编译的共享对象文件(Linux/macOS 下为 .so,Windows 下为 .pyd),例如:

site-packages/numpy/core/_multiarray_umath.cpython-311-darwin.so

该二进制文件由 C 源码(主要位于 numpy/_core/src/multiarray/multiarraymodule.c)经 CPython C API 编译生成。其中最关键的结构是 PyMethodDef 数组,它显式声明了哪些 C 函数将暴露为 Python 可调用的方法:

// numpy/_core/src/multiarray/multiarraymodule.c
static PyMethodDef array_module_methods[] = {
    // ...
    {"array",
        (PyCFunction)array_array,           // 绑定到 C 函数 array_array()
        METH_FASTCALL | METH_KEYWORDS,      // 支持快速调用 + 关键字参数
        NULL},
    // ...
    {NULL, NULL, 0, NULL}  // 结束标记
};

随后,该方法表被传入模块定义结构体,并在模块初始化时注册:

立即学习Python免费学习笔记(深入)”;

Lyrics Generator
Lyrics Generator

免费人工智能歌词生成器和人工智能歌曲作家

下载
static struct PyModuleDef moduledef = {
    PyModuleDef_HEAD_INIT,
    "_multiarray_umath",     // 模块名(Python 中 import 的名称)
    NULL,
    -1,
    array_module_methods,    // 关键:绑定所有 C 函数
    NULL, NULL, NULL, NULL
};

PyMODINIT_FUNC PyInit__multiarray_umath(void) {
    PyObject *m;
    m = PyModule_Create(&moduledef);
    if (m == NULL) return NULL;
    // ... 其他初始化逻辑(如添加常量、类型等)
    return m;
}

当 Python 执行 import numpy.core._multiarray_umath 时,解释器自动加载对应 .so 文件,调用 PyInit__multiarray_umath 初始化模块,并将 array_module_methods 中声明的每个条目(如 "array")作为模块属性注入——此时 numpy.core._multiarray_umath.array 即是一个指向 array_array C 函数的 builtin_function_or_method 对象。

验证:Python 层面的直接映射

你可以通过以下代码验证该绑定关系的真实性:

import numpy as np
import numpy.core._multiarray_umath as mu

# 二者完全等价,是同一对象
print(mu.array is np.array)  # True

# 尝试反汇编:无法获取字节码 → 确认为内置 C 函数
import dis
try:
    dis.dis(np.array)
except TypeError as e:
    print(e)  # "don't know how to disassemble builtin_function_or_method objects"
✅ 注意:np.array 并非 Python 函数包装器(如 @array_function_from_c_func_and_dispatcher 装饰的 empty_like),而是直连 C 函数的原始入口。装饰器方案用于支持 __array_function__ 协议的高级封装函数,而 array、zeros、copy 等基础构造函数走的是更底层、零开销的 C 扩展路径。

补充说明:从 _multiarray_umath.array 到 np.array 的导入链

虽然调用发生在 _multiarray_umath 模块,但用户最终使用的是 np.array。这一映射通过多层 __init__.py 导入和 sys.modules 动态挂载实现(例如 numpy/__init__.py 中 from numpy.core import multiarray,再经 multiarray.py 中 from numpy.core._multiarray_umath import array),但该过程仅影响命名空间组织,不引入任何额外调用开销——np.array() 调用仍直接路由至 C 函数。

总结与建议

  • 本质:NumPy 的核心函数是标准 CPython C 扩展,遵循 Extending Python with C 规范;
  • 性能关键:METH_FASTCALL | METH_KEYWORDS 标志启用 Python 3.6+ 最快的参数传递协议,避免传统 *args, **kwargs 解包开销;
  • ⚠️ 调试提示:若需定位某函数的 C 实现,可先查 multiarraymodule.c 中的 PyMethodDef 条目,再按函数名(如 array_array)搜索具体实现;
  • ? 进阶参考:PyCFunction 类型、PyModule_Create 流程、CPython 的 Objects/methodobject.c 是理解底层调用的关键源码节点。

掌握这一机制,不仅能深入理解 NumPy 的性能根基,也为开发高性能科学计算扩展提供了标准范式。

相关专题

更多
python开发工具
python开发工具

php中文网为大家提供各种python开发工具,好的开发工具,可帮助开发者攻克编程学习中的基础障碍,理解每一行源代码在程序执行时在计算机中的过程。php中文网还为大家带来python相关课程以及相关文章等内容,供大家免费下载使用。

759

2023.06.15

python打包成可执行文件
python打包成可执行文件

本专题为大家带来python打包成可执行文件相关的文章,大家可以免费的下载体验。

639

2023.07.20

python能做什么
python能做什么

python能做的有:可用于开发基于控制台的应用程序、多媒体部分开发、用于开发基于Web的应用程序、使用python处理数据、系统编程等等。本专题为大家提供python相关的各种文章、以及下载和课程。

762

2023.07.25

format在python中的用法
format在python中的用法

Python中的format是一种字符串格式化方法,用于将变量或值插入到字符串中的占位符位置。通过format方法,我们可以动态地构建字符串,使其包含不同值。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

618

2023.07.31

python教程
python教程

Python已成为一门网红语言,即使是在非编程开发者当中,也掀起了一股学习的热潮。本专题为大家带来python教程的相关文章,大家可以免费体验学习。

1265

2023.08.03

python环境变量的配置
python环境变量的配置

Python是一种流行的编程语言,被广泛用于软件开发、数据分析和科学计算等领域。在安装Python之后,我们需要配置环境变量,以便在任何位置都能够访问Python的可执行文件。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

548

2023.08.04

python eval
python eval

eval函数是Python中一个非常强大的函数,它可以将字符串作为Python代码进行执行,实现动态编程的效果。然而,由于其潜在的安全风险和性能问题,需要谨慎使用。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

579

2023.08.04

scratch和python区别
scratch和python区别

scratch和python的区别:1、scratch是一种专为初学者设计的图形化编程语言,python是一种文本编程语言;2、scratch使用的是基于积木的编程语法,python采用更加传统的文本编程语法等等。本专题为大家提供scratch和python相关的文章、下载、课程内容,供大家免费下载体验。

709

2023.08.11

高德地图升级方法汇总
高德地图升级方法汇总

本专题整合了高德地图升级相关教程,阅读专题下面的文章了解更多详细内容。

68

2026.01.16

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
PostgreSQL 教程
PostgreSQL 教程

共48课时 | 7.4万人学习

Git 教程
Git 教程

共21课时 | 2.8万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号