Text of docs.python.org › uk › 3 › extending › index.html as Styx crawled it on Nov 19, 2026. The page may have changed since. Only its words are kept, without pictures or layout.

Open the live page

Розширення та вбудовування інтерпретатора Python — Python 3.15.2 documentation

Навігація індекс модулі | наступний | попередній | Python » 3.15.2 documentation » Розширення та вбудовування інтерпретатора Python | Theme | Розширення та вбудовування інтерпретатора Python ¶ This document describes how to write modules in C or C++ to extend the Python interpreter with new modules. Those modules can do what Python code does – define functions, object types and methods – but also interact with native libraries or achieve better performance by avoiding the overhead of an interpreter.

The document also describes how to embed the Python interpreter in another application, for use as an extension language. Finally, it shows how to compile and link extension modules so that they can be loaded dynamically (at run time) into the interpreter, if the underlying operating system supports this feature. This document assumes basic knowledge about C and Python. For an informal introduction to Python, see Підручник з Python .

Довідник з мови Python gives a more formal definition of the language. Python built-ins reference documents the built-in functions and object types, and The Python standard library documents the modules (both built-in and written in Python) that give the language its wide application range. Для детального опису всього API Python/C перегляньте окремий Python/C API reference manual .

To support extensions, Python’s C API (Application Programmers Interface) defines a set of functions, macros and variables that provide access to most aspects of the Python run-time system. The Python API is incorporated in a C source file by including the header "Python.h" . Примітка The C extension interface is specific to CPython, and extension modules do not work on other Python implementations. In many cases, it is possible to avoid writing C extensions and preserve portability to other implementations.

For example, if your use case is calling C library functions or system calls, you should consider using the ctypes module or the cffi library rather than writing custom C code. These modules let you write Python code to interface with C code and are more portable between implementations of Python than writing and compiling a C extension module. Рекомендовані сторонні інструменти ¶ This document only covers the basic tools for creating extensions provided as part of this version of CPython.

Some third party tools offer both simpler and more sophisticated approaches to creating C and C++ extensions for Python. While this document is aimed at extension authors, it should also be helpful to the authors of such tools. For example, the tutorial module can serve as a simple test case for a build tool or sample expected output of a code generator. C API Tutorial ¶ This tutorial describes how to write a simple module in C or C++, using the Python C API – that is, using the basic tools provided as part of this version of CPython.

Your first C API extension module Guides for intermediate topics ¶ У цьому розділі посібника описано створення розширень C і C++ без допомоги сторонніх інструментів. Він призначений насамперед для розробників цих інструментів, а не як рекомендований спосіб створення власних розширень C.

Using the C API: Assorted topics Визначення типів розширень: підручник Визначення типів розширень: різні теми Створення розширень C і C++ Створення розширень C і C++ у Windows Вбудовування середовища виконання CPython у більшу програму ¶ Іноді замість створення розширення, яке працює в інтерпретаторі Python як основної програми, бажано замість цього вбудувати середовище виконання CPython у більшу програму.

У цьому розділі описано деякі деталі, необхідні для успішного виконання цього завдання. Вбудовування Python в іншу програму Table of Contents Розширення та вбудовування інтерпретатора Python Рекомендовані сторонні інструменти C API Tutorial Guides for intermediate topics Вбудовування середовища виконання CPython у більшу програму Попередній розділ Міркування безпеки Наступна тема Your first C API extension module This page Report a bug Improve this page Show source Show translation source « Навігація індекс модулі | наступний | попередній | Python » 3.15.2 documentation » Розширення та вбудовування інтерпретатора Python | Theme | © Авторське право 2001 Python Software Foundation.

This page is licensed under the Python Software Foundation License Version 2. Examples, recipes, and other code in the documentation are additionally licensed under the Zero Clause BSD License. See History and License for more information. The Python Software Foundation is a non-profit corporation. Please donate. Востаннє оновлено лист. 19, 2026 (11:14 UTC). Found a bug ? Created using Sphinx 9.1.1.