353 lines
20 KiB
HTML
353 lines
20 KiB
HTML
|
|
<!DOCTYPE html>
|
|
|
|
<html xmlns="http://www.w3.org/1999/xhtml" lang="zh_CN">
|
|
<head>
|
|
<meta charset="utf-8" /><meta name="generator" content="Docutils 0.17.1: http://docutils.sourceforge.net/" />
|
|
|
|
<title>扩展和嵌入 Python 解释器 — Python 3.8.20 文档</title><meta name="viewport" content="width=device-width, initial-scale=1.0">
|
|
|
|
<link rel="stylesheet" href="../_static/pydoctheme.css" type="text/css" />
|
|
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
|
|
|
|
<script id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
|
|
<script src="../_static/jquery.js"></script>
|
|
<script src="../_static/underscore.js"></script>
|
|
<script src="../_static/doctools.js"></script>
|
|
<script src="../_static/language_data.js"></script>
|
|
<script src="../_static/translations.js"></script>
|
|
|
|
<script src="../_static/sidebar.js"></script>
|
|
|
|
<link rel="search" type="application/opensearchdescription+xml"
|
|
title="在 Python 3.8.20 文档 中搜索"
|
|
href="../_static/opensearch.xml"/>
|
|
<link rel="author" title="关于这些文档" href="../about.html" />
|
|
<link rel="index" title="索引" href="../genindex.html" />
|
|
<link rel="search" title="搜索" href="../search.html" />
|
|
<link rel="copyright" title="版权所有" href="../copyright.html" />
|
|
<link rel="next" title="1. 使用 C 或 C++ 扩展 Python" href="extending.html" />
|
|
<link rel="prev" title="未创建文档的模块" href="../library/undoc.html" />
|
|
<link rel="canonical" href="https://docs.python.org/3/extending/index.html" />
|
|
|
|
|
|
|
|
|
|
|
|
<style>
|
|
@media only screen {
|
|
table.full-width-table {
|
|
width: 100%;
|
|
}
|
|
}
|
|
</style>
|
|
<link rel="shortcut icon" type="image/png" href="../_static/py.svg" />
|
|
<script type="text/javascript" src="../_static/copybutton.js"></script>
|
|
<script type="text/javascript" src="../_static/menu.js"></script>
|
|
|
|
</head>
|
|
<body>
|
|
<div class="mobile-nav">
|
|
<input type="checkbox" id="menuToggler" class="toggler__input" aria-controls="navigation"
|
|
aria-pressed="false" aria-expanded="false" role="button" aria-label="Menu" />
|
|
<label for="menuToggler" class="toggler__label">
|
|
<span></span>
|
|
</label>
|
|
<nav class="nav-content" role="navigation">
|
|
<a href="https://www.python.org/" class="nav-logo">
|
|
<img src="../_static/py.svg" alt="Logo"/>
|
|
</a>
|
|
<div class="version_switcher_placeholder"></div>
|
|
<form role="search" class="search" action="../search.html" method="get">
|
|
<svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" class="search-icon">
|
|
<path fill-rule="nonzero"
|
|
d="M15.5 14h-.79l-.28-.27a6.5 6.5 0 001.48-5.34c-.47-2.78-2.79-5-5.59-5.34a6.505 6.505 0 00-7.27 7.27c.34 2.8 2.56 5.12 5.34 5.59a6.5 6.5 0 005.34-1.48l.27.28v.79l4.25 4.25c.41.41 1.08.41 1.49 0 .41-.41.41-1.08 0-1.49L15.5 14zm-6 0C7.01 14 5 11.99 5 9.5S7.01 5 9.5 5 14 7.01 14 9.5 11.99 14 9.5 14z" fill="#444"></path>
|
|
</svg>
|
|
<input type="text" name="q" aria-label="快速搜索"/>
|
|
<input type="submit" value="转向"/>
|
|
</form>
|
|
</nav>
|
|
<div class="menu-wrapper">
|
|
<nav class="menu" role="navigation" aria-label="main navigation">
|
|
<div class="language_switcher_placeholder"></div>
|
|
<h3><a href="../contents.html">目录</a></h3>
|
|
<ul>
|
|
<li><a class="reference internal" href="#">扩展和嵌入 Python 解释器</a><ul>
|
|
<li><a class="reference internal" href="#recommended-third-party-tools">推荐的第三方工具</a></li>
|
|
<li><a class="reference internal" href="#creating-extensions-without-third-party-tools">不使用第三方工具创建扩展</a></li>
|
|
<li><a class="reference internal" href="#embedding-the-cpython-runtime-in-a-larger-application">在更大的应用程序中嵌入 CPython 运行时</a></li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
|
|
<h4>上一个主题</h4>
|
|
<p class="topless"><a href="../library/undoc.html"
|
|
title="上一章">未创建文档的模块</a></p>
|
|
<h4>下一个主题</h4>
|
|
<p class="topless"><a href="extending.html"
|
|
title="下一章"><span class="section-number">1. </span>使用 C 或 C++ 扩展 Python</a></p>
|
|
<div role="note" aria-label="source link">
|
|
<h3>本页</h3>
|
|
<ul class="this-page-menu">
|
|
<li><a href="../bugs.html">报告 Bug</a></li>
|
|
<li>
|
|
<a href="https://github.com/python/cpython/blob/3.8/Doc/extending/index.rst"
|
|
rel="nofollow">显示源代码
|
|
</a>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</nav>
|
|
</div>
|
|
</div>
|
|
|
|
<div id="outdated-warning" style="padding: .5em; text-align: center; background-color: #FFBABA; color: #6A0E0E;">
|
|
这个文档所针对的是一个已不再受支持的 Python 旧版本。
|
|
你应当升级版本，并阅读
|
|
<a href="/3/extending/index.html"> Python 当前稳定版本的文档</a>.
|
|
</div>
|
|
|
|
<div class="related" role="navigation" aria-label="related navigation">
|
|
<h3>导航</h3>
|
|
<ul>
|
|
<li class="right" style="margin-right: 10px">
|
|
<a href="../genindex.html" title="总目录"
|
|
accesskey="I">索引</a></li>
|
|
<li class="right" >
|
|
<a href="../py-modindex.html" title="Python 模块索引"
|
|
>模块</a> |</li>
|
|
<li class="right" >
|
|
<a href="extending.html" title="1. 使用 C 或 C++ 扩展 Python"
|
|
accesskey="N">下一页</a> |</li>
|
|
<li class="right" >
|
|
<a href="../library/undoc.html" title="未创建文档的模块"
|
|
accesskey="P">上一页</a> |</li>
|
|
|
|
<li><img src="../_static/py.svg" alt="python logo" style="vertical-align: middle; margin-top: -1px"/></li>
|
|
<li><a href="https://www.python.org/">Python</a> »</li>
|
|
<li class="switchers">
|
|
<div class="language_switcher_placeholder"></div>
|
|
<div class="version_switcher_placeholder"></div>
|
|
</li>
|
|
<li>
|
|
|
|
</li>
|
|
<li id="cpython-language-and-version">
|
|
<a href="../index.html">3.8.20 Documentation</a> »
|
|
</li>
|
|
|
|
<li class="right">
|
|
|
|
|
|
<div class="inline-search" role="search">
|
|
<form class="inline-search" action="../search.html" method="get">
|
|
<input placeholder="快速搜索" aria-label="快速搜索" type="text" name="q" />
|
|
<input type="submit" value="转向" />
|
|
<input type="hidden" name="check_keywords" value="yes" />
|
|
<input type="hidden" name="area" value="default" />
|
|
</form>
|
|
</div>
|
|
|
|
|
</li>
|
|
|
|
</ul>
|
|
</div>
|
|
|
|
<div class="document">
|
|
<div class="documentwrapper">
|
|
<div class="bodywrapper">
|
|
<div class="body" role="main">
|
|
|
|
<section id="extending-and-embedding-the-python-interpreter">
|
|
<span id="extending-index"></span><h1>扩展和嵌入 Python 解释器<a class="headerlink" href="#extending-and-embedding-the-python-interpreter" title="永久链接至标题">¶</a></h1>
|
|
<p>本文档描述了如何使用 C 或 C++ 编写模块以使用新模块来扩展 Python 解释器的功能。 这些模块不仅可以定义新的函数，还可以定义新的对象类型及其方法。 该文档还描述了如何将 Python 解释器嵌入到另一个应用程序中，以用作扩展语言。 最后，它展示了如何编译和链接扩展模块，以便它们可以动态地（在运行时）加载到解释器中，如果底层操作系统支持此特性的话。</p>
|
|
<p>本文档假设你具备有关 Python 的基本知识。有关该语言的非正式介绍，请参阅 <a class="reference internal" href="../tutorial/index.html#tutorial-index"><span class="std std-ref">Python 教程</span></a> 。 <a class="reference internal" href="../reference/index.html#reference-index"><span class="std std-ref">Python语言参考</span></a> 给出了更正式的语言定义。 <a class="reference internal" href="../library/index.html#library-index"><span class="std std-ref">Python 标准库</span></a> 包含现有的对象类型、函数和模块（内置和用 Python 编写）的文档，使语言具有广泛的应用范围。</p>
|
|
<p>关于整个 Python/C API 的详细介绍，请参阅独立的 <a class="reference internal" href="../c-api/index.html#c-api-index"><span class="std std-ref">Python/C API 参考手册</span></a> 。</p>
|
|
<section id="recommended-third-party-tools">
|
|
<h2>推荐的第三方工具<a class="headerlink" href="#recommended-third-party-tools" title="永久链接至标题">¶</a></h2>
|
|
<p>本指南仅介绍了作为此 CPython 版本的一部分提供的创建扩展的基本工具。 第三方工具，如 <a class="reference external" href="http://cython.org/">Cython</a> 、 <a class="reference external" href="https://cffi.readthedocs.io">cffi</a> 、 <a class="reference external" href="http://www.swig.org">SWIG</a> 和 <a class="reference external" href="https://numba.pydata.org/">Numba</a> 提供了更简单和更复杂的方法来为 Python 创建 C 和 C ++ 扩展。</p>
|
|
<div class="admonition seealso">
|
|
<p class="admonition-title">参见</p>
|
|
<dl class="simple">
|
|
<dt><a class="reference external" href="https://packaging.python.org/guides/packaging-binary-extensions/">Python Packaging User Guide: Binary Extensions</a></dt><dd><p>“ Python Packaging User Guide ”不仅涵盖了几个简化二进制扩展创建的可用工具，还讨论了为什么首先创建扩展模块的各种原因。</p>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
</section>
|
|
<section id="creating-extensions-without-third-party-tools">
|
|
<h2>不使用第三方工具创建扩展<a class="headerlink" href="#creating-extensions-without-third-party-tools" title="永久链接至标题">¶</a></h2>
|
|
<p>本指南的这一部分包括在没有第三方工具帮助的情况下创建 C 和 C ++ 扩展。它主要用于这些工具的创建者，而不是建议你创建自己的 C 扩展的方法。</p>
|
|
<div class="toctree-wrapper compound">
|
|
<ul>
|
|
<li class="toctree-l1"><a class="reference internal" href="extending.html">1. 使用 C 或 C++ 扩展 Python</a><ul>
|
|
<li class="toctree-l2"><a class="reference internal" href="extending.html#a-simple-example">1.1. 一个简单的例子</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="extending.html#intermezzo-errors-and-exceptions">1.2. 关于错误和异常</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="extending.html#back-to-the-example">1.3. 回到例子</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="extending.html#the-module-s-method-table-and-initialization-function">1.4. 模块方法表和初始化函数</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="extending.html#compilation-and-linkage">1.5. 编译和链接</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="extending.html#calling-python-functions-from-c">1.6. 在C中调用Python函数</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="extending.html#extracting-parameters-in-extension-functions">1.7. 提取扩展函数的参数</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="extending.html#keyword-parameters-for-extension-functions">1.8. 给扩展函数的关键字参数</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="extending.html#building-arbitrary-values">1.9. 构造任意值</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="extending.html#reference-counts">1.10. 引用计数</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="extending.html#writing-extensions-in-c">1.11. 在C++中编写扩展</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="extending.html#providing-a-c-api-for-an-extension-module">1.12. 给扩展模块提供C API</a></li>
|
|
</ul>
|
|
</li>
|
|
<li class="toctree-l1"><a class="reference internal" href="newtypes_tutorial.html">2. 自定义扩展类型：教程</a><ul>
|
|
<li class="toctree-l2"><a class="reference internal" href="newtypes_tutorial.html#the-basics">2.1. 基础</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="newtypes_tutorial.html#adding-data-and-methods-to-the-basic-example">2.2. 向基本示例添加数据和方法</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="newtypes_tutorial.html#providing-finer-control-over-data-attributes">2.3. 提供对于数据属性的更精细控制</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="newtypes_tutorial.html#supporting-cyclic-garbage-collection">2.4. 支持循环垃圾回收</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="newtypes_tutorial.html#subclassing-other-types">2.5. 子类化其他类型</a></li>
|
|
</ul>
|
|
</li>
|
|
<li class="toctree-l1"><a class="reference internal" href="newtypes.html">3. 定义扩展类型：已分类主题</a><ul>
|
|
<li class="toctree-l2"><a class="reference internal" href="newtypes.html#finalization-and-de-allocation">3.1. 终结和内存释放</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="newtypes.html#object-presentation">3.2. 对象展示</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="newtypes.html#attribute-management">3.3. 属性管理</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="newtypes.html#object-comparison">3.4. 对象比较</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="newtypes.html#abstract-protocol-support">3.5. 抽象协议支持</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="newtypes.html#weak-reference-support">3.6. 弱引用支持</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="newtypes.html#more-suggestions">3.7. 更多建议</a></li>
|
|
</ul>
|
|
</li>
|
|
<li class="toctree-l1"><a class="reference internal" href="building.html">4. 构建C/C++扩展</a><ul>
|
|
<li class="toctree-l2"><a class="reference internal" href="building.html#building-c-and-c-extensions-with-distutils">4.1. 使用distutils构建C和C++扩展</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="building.html#distributing-your-extension-modules">4.2. 发布你的扩展模块</a></li>
|
|
</ul>
|
|
</li>
|
|
<li class="toctree-l1"><a class="reference internal" href="windows.html">5. 在Windows平台编译C和C++扩展</a><ul>
|
|
<li class="toctree-l2"><a class="reference internal" href="windows.html#a-cookbook-approach">5.1. 菜谱式说明</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="windows.html#differences-between-unix-and-windows">5.2. Unix 和 Windows 之间的差异</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="windows.html#using-dlls-in-practice">5.3. DLL 的实际使用</a></li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</section>
|
|
<section id="embedding-the-cpython-runtime-in-a-larger-application">
|
|
<h2>在更大的应用程序中嵌入 CPython 运行时<a class="headerlink" href="#embedding-the-cpython-runtime-in-a-larger-application" title="永久链接至标题">¶</a></h2>
|
|
<p>有时，不是要创建在 Python 解释器中作为主应用程序运行的扩展，而是希望将 CPython 运行时嵌入到更大的应用程序中。 本节介绍了成功完成此操作所涉及的一些细节。</p>
|
|
<div class="toctree-wrapper compound">
|
|
<ul>
|
|
<li class="toctree-l1"><a class="reference internal" href="embedding.html">1. 在其它应用程序嵌入 Python</a><ul>
|
|
<li class="toctree-l2"><a class="reference internal" href="embedding.html#very-high-level-embedding">1.1. 高层次的嵌入</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="embedding.html#beyond-very-high-level-embedding-an-overview">1.2. 突破高层次嵌入的限制：概述</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="embedding.html#pure-embedding">1.3. 纯嵌入</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="embedding.html#extending-embedded-python">1.4. 对嵌入 Python 功能进行扩展</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="embedding.html#embedding-python-in-c">1.5. 在 C++ 中嵌入 Python</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="embedding.html#compiling-and-linking-under-unix-like-systems">1.6. 在类 Unix 系统中编译和链接</a></li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</section>
|
|
</section>
|
|
|
|
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div class="sphinxsidebar" role="navigation" aria-label="main navigation">
|
|
<div class="sphinxsidebarwrapper">
|
|
<h3><a href="../contents.html">目录</a></h3>
|
|
<ul>
|
|
<li><a class="reference internal" href="#">扩展和嵌入 Python 解释器</a><ul>
|
|
<li><a class="reference internal" href="#recommended-third-party-tools">推荐的第三方工具</a></li>
|
|
<li><a class="reference internal" href="#creating-extensions-without-third-party-tools">不使用第三方工具创建扩展</a></li>
|
|
<li><a class="reference internal" href="#embedding-the-cpython-runtime-in-a-larger-application">在更大的应用程序中嵌入 CPython 运行时</a></li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
|
|
<h4>上一个主题</h4>
|
|
<p class="topless"><a href="../library/undoc.html"
|
|
title="上一章">未创建文档的模块</a></p>
|
|
<h4>下一个主题</h4>
|
|
<p class="topless"><a href="extending.html"
|
|
title="下一章"><span class="section-number">1. </span>使用 C 或 C++ 扩展 Python</a></p>
|
|
<div role="note" aria-label="source link">
|
|
<h3>本页</h3>
|
|
<ul class="this-page-menu">
|
|
<li><a href="../bugs.html">报告 Bug</a></li>
|
|
<li>
|
|
<a href="https://github.com/python/cpython/blob/3.8/Doc/extending/index.rst"
|
|
rel="nofollow">显示源代码
|
|
</a>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div class="clearer"></div>
|
|
</div>
|
|
<div class="related" role="navigation" aria-label="related navigation">
|
|
<h3>导航</h3>
|
|
<ul>
|
|
<li class="right" style="margin-right: 10px">
|
|
<a href="../genindex.html" title="总目录"
|
|
>索引</a></li>
|
|
<li class="right" >
|
|
<a href="../py-modindex.html" title="Python 模块索引"
|
|
>模块</a> |</li>
|
|
<li class="right" >
|
|
<a href="extending.html" title="1. 使用 C 或 C++ 扩展 Python"
|
|
>下一页</a> |</li>
|
|
<li class="right" >
|
|
<a href="../library/undoc.html" title="未创建文档的模块"
|
|
>上一页</a> |</li>
|
|
|
|
<li><img src="../_static/py.svg" alt="python logo" style="vertical-align: middle; margin-top: -1px"/></li>
|
|
<li><a href="https://www.python.org/">Python</a> »</li>
|
|
<li class="switchers">
|
|
<div class="language_switcher_placeholder"></div>
|
|
<div class="version_switcher_placeholder"></div>
|
|
</li>
|
|
<li>
|
|
|
|
</li>
|
|
<li id="cpython-language-and-version">
|
|
<a href="../index.html">3.8.20 Documentation</a> »
|
|
</li>
|
|
|
|
<li class="right">
|
|
|
|
|
|
<div class="inline-search" role="search">
|
|
<form class="inline-search" action="../search.html" method="get">
|
|
<input placeholder="快速搜索" aria-label="快速搜索" type="text" name="q" />
|
|
<input type="submit" value="转向" />
|
|
<input type="hidden" name="check_keywords" value="yes" />
|
|
<input type="hidden" name="area" value="default" />
|
|
</form>
|
|
</div>
|
|
|
|
|
</li>
|
|
|
|
</ul>
|
|
</div>
|
|
<div class="footer">
|
|
© <a href="../copyright.html">版权所有</a> 2001-2024, Python Software Foundation.
|
|
<br />
|
|
This page is licensed under the Python Software Foundation License Version 2.
|
|
<br />
|
|
Examples, recipes, and other code in the documentation are additionally licensed under the Zero Clause BSD License.
|
|
<br />
|
|
|
|
<br />
|
|
|
|
The Python Software Foundation is a non-profit corporation.
|
|
<a href="https://www.python.org/psf/donations/">Please donate.</a>
|
|
<br />
|
|
<br />
|
|
|
|
最后更新于 12月 09, 2024.
|
|
<a href="https://docs.python.org/3/bugs.html">Found a bug</a>?
|
|
<br />
|
|
|
|
Created using <a href="https://www.sphinx-doc.org/">Sphinx</a> 2.4.4.
|
|
</div>
|
|
|
|
</body>
|
|
</html> |