Рівень дуже високого рівня¶
Функції в цій главі дозволять вам виконувати вихідний код Python, поданий у файлі або буфері, але вони не дозволять вам більш детально взаємодіяти з інтерпретатором.
Several of these functions accept a start symbol from the grammar as a
parameter. The available start symbols are Py_eval_input
,
Py_file_input
, and Py_single_input
. These are described
following the functions which accept them as parameters.
Note also that several of these functions take FILE*
parameters. One
particular issue which needs to be handled carefully is that the FILE
structure for different C libraries can be different and incompatible. Under
Windows (at least), it is possible for dynamically linked extensions to actually
use different libraries, so care should be taken that FILE*
parameters
are only passed to these functions if it is certain that they were created by
the same library that the Python runtime is using.
-
int
Py_Main
(int argc, wchar_t **argv)¶ Основна програма для стандартного інтерпретатора. Це доступно для програм, які вбудовують Python. Параметри argc і argv мають бути підготовлені точно так само, як ті, що передаються до функції
main()
програми C (перетворюються на wchar_t відповідно до локалі користувача). Важливо зауважити, що список аргументів може бути змінений (але не вміст рядків, на які вказує список аргументів). Поверненим значенням буде0
, якщо інтерпретатор завершує роботу нормально (тобто без винятку),1
,1
, якщо інтерпретатор завершує роботу через виняток, або2
, якщо список параметрів не представляє дійсний командний рядок Python.Note that if an otherwise unhandled
SystemExit
is raised, this function will not return1
, but exit the process, as long asPy_InspectFlag
is not set.
-
int
Py_BytesMain
(int argc, char **argv)¶ Подібно до
Py_Main()
, але argv — це масив рядків байтів.Нове в версії 3.8.
-
int
PyRun_AnyFile
(FILE *fp, const char *filename)¶ Це спрощений інтерфейс для
PyRun_AnyFileExFlags()
нижче, залишаючи closeit встановленим на0
і flags встановленим наNULL
.
-
int
PyRun_AnyFileFlags
(FILE *fp, const char *filename, PyCompilerFlags *flags)¶ Це спрощений інтерфейс для
PyRun_AnyFileExFlags()
нижче, залишаючи аргумент closeit встановленим на0
.
-
int
PyRun_AnyFileEx
(FILE *fp, const char *filename, int closeit)¶ Це спрощений інтерфейс для
PyRun_AnyFileExFlags()
нижче, залишаючи для аргументу flags значенняNULL
.
-
int
PyRun_AnyFileExFlags
(FILE *fp, const char *filename, int closeit, PyCompilerFlags *flags)¶ Якщо fp посилається на файл, пов’язаний з інтерактивним пристроєм (консоль або термінал введення чи псевдотермінал Unix), повертає значення
PyRun_InteractiveLoop()
, інакше повертає результатPyRun_SimpleFile()
.*ім’я файлу* розшифровується з кодування файлової системи (sys.getfilesystemencoding()
). Якщо ім’я файлу має значенняNULL
, ця функція використовує"???"
як ім’я файлу. Якщо closeit має значення true, файл закривається до поверненняPyRun_SimpleFileExFlags()
.
-
int
PyRun_SimpleString
(const char *command)¶ This is a simplified interface to
PyRun_SimpleStringFlags()
below, leaving thePyCompilerFlags
* argument set toNULL
.
-
int
PyRun_SimpleStringFlags
(const char *command, PyCompilerFlags *flags)¶ Виконує вихідний код Python з команди в модулі
__main__
відповідно до аргументу flags. Якщо__main__
ще не існує, він буде створений. Повертає0
у разі успіху або-1
, якщо було викликано виключення. Якщо сталася помилка, неможливо отримати інформацію про винятки. Про значення прапорів дивіться нижче.Note that if an otherwise unhandled
SystemExit
is raised, this function will not return-1
, but exit the process, as long asPy_InspectFlag
is not set.
-
int
PyRun_SimpleFile
(FILE *fp, const char *filename)¶ Це спрощений інтерфейс для
PyRun_SimpleFileExFlags()
нижче, залишаючи closeit встановленим на0
і flags встановленим наNULL
.
-
int
PyRun_SimpleFileEx
(FILE *fp, const char *filename, int closeit)¶ Це спрощений інтерфейс для
PyRun_SimpleFileExFlags()
нижче, залишаючи flags встановленими наNULL
.
-
int
PyRun_SimpleFileExFlags
(FILE *fp, const char *filename, int closeit, PyCompilerFlags *flags)¶ Similar to
PyRun_SimpleStringFlags()
, but the Python source code is read from fp instead of an in-memory string. filename should be the name of the file, it is decoded from the filesystem encoding (sys.getfilesystemencoding()
). If closeit is true, the file is closed before PyRun_SimpleFileExFlags returns.Примітка
У Windows fp слід відкривати як бінарний режим (наприклад,
fopen(filename, "rb")
). Інакше Python може неправильно обробити файл сценарію з закінченням рядка LF.
-
int
PyRun_InteractiveOne
(FILE *fp, const char *filename)¶ Це спрощений інтерфейс для
PyRun_InteractiveOneFlags()
нижче, залишаючи flags встановленими наNULL
.
-
int
PyRun_InteractiveOneFlags
(FILE *fp, const char *filename, PyCompilerFlags *flags)¶ Read and execute a single statement from a file associated with an interactive device according to the flags argument. The user will be prompted using
sys.ps1
andsys.ps2
. filename is decoded from the filesystem encoding (sys.getfilesystemencoding()
).Повертає
0
, якщо введення було виконано успішно,-1
, якщо стався виняток, або код помилки з файлу включенняerrcode.h
, який поширюється як частина Python, якщо був помилка аналізу. (Зауважте, щоerrcode.h
не включено вPython.h
, тому його потрібно включити спеціально, якщо це необхідно.)
-
int
PyRun_InteractiveLoop
(FILE *fp, const char *filename)¶ Це спрощений інтерфейс для
PyRun_InteractiveLoopFlags()
нижче, залишаючи flags встановленими наNULL
.
-
int
PyRun_InteractiveLoopFlags
(FILE *fp, const char *filename, PyCompilerFlags *flags)¶ Read and execute statements from a file associated with an interactive device until EOF is reached. The user will be prompted using
sys.ps1
andsys.ps2
. filename is decoded from the filesystem encoding (sys.getfilesystemencoding()
). Returns0
at EOF or a negative number upon failure.
-
int
(*PyOS_InputHook)
(void)¶ Може вказувати на функцію з прототипом
int func(void)
. Функція буде викликана, коли підказка інтерпретатора Python збирається перейти в режим очікування та чекати введення користувача з терміналу. Повернене значення ігнорується. Перевизначення цього хука можна використати для інтеграції підказки інтерпретатора з іншими циклами подій, як це зроблено вModules/_tkinter.c
у вихідному коді Python.
-
char*
(*PyOS_ReadlineFunctionPointer)
(FILE *, FILE *, const char *)¶ Можна налаштувати так, щоб вказувати на функцію з прототипом
char *func(FILE *stdin, FILE *stdout, char *prompt)
, замінюючи функцію за замовчуванням, яка використовується для читання одного рядка введення в підказці інтерпретатора. Очікується, що функція виведе рядок prompt, якщо він неNULL
, а потім прочитає рядок введення з наданого стандартного файлу введення, повертаючи результуючий рядок. Наприклад, модульreadline
встановлює цей хук для надання функцій редагування рядка та завершення табуляції.Результат має бути рядком, виділеним
PyMem_RawMalloc()
абоPyMem_RawRealloc()
, абоNULL
, якщо сталася помилка.Змінено в версії 3.4: Результат має бути виділено за допомогою
PyMem_RawMalloc()
абоPyMem_RawRealloc()
, а не за допомогоюPyMem_Malloc()
абоPyMem_Realloc()
.
-
struct _node*
PyParser_SimpleParseString
(const char *str, int start)¶ This is a simplified interface to
PyParser_SimpleParseStringFlagsFilename()
below, leaving filename set toNULL
and flags set to0
.Deprecated since version 3.9, will be removed in version 3.10.
-
struct _node*
PyParser_SimpleParseStringFlags
(const char *str, int start, int flags)¶ This is a simplified interface to
PyParser_SimpleParseStringFlagsFilename()
below, leaving filename set toNULL
.Deprecated since version 3.9, will be removed in version 3.10.
-
struct _node*
PyParser_SimpleParseStringFlagsFilename
(const char *str, const char *filename, int start, int flags)¶ Parse Python source code from str using the start token start according to the flags argument. The result can be used to create a code object which can be evaluated efficiently. This is useful if a code fragment must be evaluated many times. filename is decoded from the filesystem encoding (
sys.getfilesystemencoding()
).Deprecated since version 3.9, will be removed in version 3.10.
-
struct _node*
PyParser_SimpleParseFile
(FILE *fp, const char *filename, int start)¶ This is a simplified interface to
PyParser_SimpleParseFileFlags()
below, leaving flags set to0
.Deprecated since version 3.9, will be removed in version 3.10.
-
struct _node*
PyParser_SimpleParseFileFlags
(FILE *fp, const char *filename, int start, int flags)¶ Similar to
PyParser_SimpleParseStringFlagsFilename()
, but the Python source code is read from fp instead of an in-memory string.Deprecated since version 3.9, will be removed in version 3.10.
-
PyObject*
PyRun_String
(const char *str, int start, PyObject *globals, PyObject *locals)¶ - Return value: New reference.
Це спрощений інтерфейс для
PyRun_StringFlags()
нижче, залишаючи flags встановленими наNULL
.
-
PyObject*
PyRun_StringFlags
(const char *str, int start, PyObject *globals, PyObject *locals, PyCompilerFlags *flags)¶ - Return value: New reference.
Виконайте вихідний код Python із str у контексті, визначеному об’єктами globals і locals з прапорцями компілятора, визначеними flags. globals має бути словником; locals може бути будь-яким об’єктом, який реалізує протокол відображення. Параметр start визначає початковий маркер, який слід використовувати для аналізу вихідного коду.
Повертає результат виконання коду як об’єкт Python або
NULL
, якщо було викликано виняткову ситуацію.
-
PyObject*
PyRun_File
(FILE *fp, const char *filename, int start, PyObject *globals, PyObject *locals)¶ - Return value: New reference.
Це спрощений інтерфейс для
PyRun_FileExFlags()
нижче, залишаючи closeit встановленим на0
і flags встановленим наNULL
.
-
PyObject*
PyRun_FileEx
(FILE *fp, const char *filename, int start, PyObject *globals, PyObject *locals, int closeit)¶ - Return value: New reference.
Це спрощений інтерфейс для
PyRun_FileExFlags()
нижче, залишаючи flags встановленими наNULL
.
-
PyObject*
PyRun_FileFlags
(FILE *fp, const char *filename, int start, PyObject *globals, PyObject *locals, PyCompilerFlags *flags)¶ - Return value: New reference.
Це спрощений інтерфейс для
PyRun_FileExFlags()
нижче, залишаючи closeit встановленим на0
.
-
PyObject*
PyRun_FileExFlags
(FILE *fp, const char *filename, int start, PyObject *globals, PyObject *locals, int closeit, PyCompilerFlags *flags)¶ - Return value: New reference.
Similar to
PyRun_StringFlags()
, but the Python source code is read from fp instead of an in-memory string. filename should be the name of the file, it is decoded from the filesystem encoding (sys.getfilesystemencoding()
). If closeit is true, the file is closed beforePyRun_FileExFlags()
returns.
-
PyObject*
Py_CompileString
(const char *str, const char *filename, int start)¶ - Return value: New reference.
Це спрощений інтерфейс для
Py_CompileStringFlags()
нижче, залишаючи flags встановленими наNULL
.
-
PyObject*
Py_CompileStringFlags
(const char *str, const char *filename, int start, PyCompilerFlags *flags)¶ - Return value: New reference.
Це спрощений інтерфейс для
Py_CompileStringExFlags()
нижче, з optimize встановленим на-1
.
-
PyObject*
Py_CompileStringObject
(const char *str, PyObject *filename, int start, PyCompilerFlags *flags, int optimize)¶ - Return value: New reference.
Parse and compile the Python source code in str, returning the resulting code object. The start token is given by start; this can be used to constrain the code which can be compiled and should be
Py_eval_input
,Py_file_input
, orPy_single_input
. The filename specified by filename is used to construct the code object and may appear in tracebacks orSyntaxError
exception messages. This returnsNULL
if the code cannot be parsed or compiled.Ціле число optimize визначає рівень оптимізації компілятора; значення
-1
вибирає рівень оптимізації інтерпретатора, як задано параметрами-O
. Явні рівні:0
(немає оптимізації;__debug__
є істинним),1
(затвердження видалено,__debug__
є хибним) або2
(рядки документа також видалено ).Нове в версії 3.4.
-
PyObject*
Py_CompileStringExFlags
(const char *str, const char *filename, int start, PyCompilerFlags *flags, int optimize)¶ - Return value: New reference.
Like
Py_CompileStringObject()
, but filename is a byte string decoded from the filesystem encoding (os.fsdecode()
).Нове в версії 3.2.
-
PyObject*
PyEval_EvalCode
(PyObject *co, PyObject *globals, PyObject *locals)¶ - Return value: New reference.
Це спрощений інтерфейс для
PyEval_EvalCodeEx()
лише з об’єктом коду та глобальними та локальними змінними. Інші аргументи мають значенняNULL
.
-
PyObject*
PyEval_EvalCodeEx
(PyObject *co, PyObject *globals, PyObject *locals, PyObject *const *args, int argcount, PyObject *const *kws, int kwcount, PyObject *const *defs, int defcount, PyObject *kwdefs, PyObject *closure)¶ - Return value: New reference.
Оцініть попередньо скомпільований об’єкт коду з урахуванням певного середовища для його оцінки. Це середовище складається зі словника глобальних змінних, об’єкта відображення локальних змінних, масивів аргументів, ключових слів і значень за замовчуванням, словника значень за замовчуванням для аргументів keyword-only і закриваючого кортежу клітинок.
-
PyFrameObject
¶ The C structure of the objects used to describe frame objects. The fields of this type are subject to change at any time.
-
PyObject*
PyEval_EvalFrame
(PyFrameObject *f)¶ - Return value: New reference.
Оцініть кадр виконання. Це спрощений інтерфейс для
PyEval_EvalFrameEx()
для зворотної сумісності.
-
PyObject*
PyEval_EvalFrameEx
(PyFrameObject *f, int throwflag)¶ - Return value: New reference.
Це основна функція інтерпретації Python без прикрас. Об’єкт коду, пов’язаний із кадром виконання f, виконується, інтерпретуючи байт-код і виконуючи виклики за потреби. Додатковий параметр throwflag здебільшого можна ігнорувати - якщо воно істинне, то це спричиняє миттєве виключення винятку; це використовується для методів
throw()
об’єктів генератора.Змінено в версії 3.4: Ця функція тепер включає твердження налагодження, щоб гарантувати, що вона не відкидає мовчки активний виняток.
-
int
PyEval_MergeCompilerFlags
(PyCompilerFlags *cf)¶ Ця функція змінює прапори поточного кадру оцінки та повертає true у разі успіху, false у разі невдачі.
-
int
Py_eval_input
¶ Початковий символ із граматики Python для ізольованих виразів; для використання з
Py_CompileString()
.
-
int
Py_file_input
¶ Початковий символ із граматики Python для послідовностей операторів, прочитаних із файлу чи іншого джерела; для використання з
Py_CompileString()
. Це символ, який слід використовувати під час компіляції будь-якої довжини вихідного коду Python.
-
int
Py_single_input
¶ Початковий символ із граматики Python для окремого оператора; для використання з
Py_CompileString()
. Це символ, який використовується для інтерактивного циклу інтерпретатора.
-
struct
PyCompilerFlags
¶ Це структура, яка використовується для зберігання прапорів компілятора. У випадках, коли код лише компілюється, він передається як
прапорці int
, а у випадках, коли код виконується, він передається якPyCompilerFlags *flags
. У цьому випадкуfrom __future__ import
може змінювати прапори.Whenever
PyCompilerFlags *flags
isNULL
,cf_flags
is treated as equal to0
, and any modification due tofrom __future__ import
is discarded.-
int
cf_flags
¶ Прапори компілятора.
-
int
cf_feature_version
¶ cf_feature_version є другорядною версією Python. Його слід ініціалізувати як
PY_MINOR_VERSION
.The field is ignored by default, it is used if and only if
PyCF_ONLY_AST
flag is set in cf_flags.
Змінено в версії 3.8: Додано поле cf_feature_version.
-
int