forked from AFPy/python-docs-fr
458 lines
16 KiB
Plaintext
458 lines
16 KiB
Plaintext
# Copyright (C) 2001-2018, Python Software Foundation
|
|
# For licence information, see README file.
|
|
#
|
|
msgid ""
|
|
msgstr ""
|
|
"Project-Id-Version: Python 3\n"
|
|
"Report-Msgid-Bugs-To: \n"
|
|
"POT-Creation-Date: 2020-08-24 09:01+0200\n"
|
|
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
|
|
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
|
|
"Language-Team: FRENCH <traductions@lists.afpy.org>\n"
|
|
"Language: fr\n"
|
|
"MIME-Version: 1.0\n"
|
|
"Content-Type: text/plain; charset=UTF-8\n"
|
|
"Content-Transfer-Encoding: 8bit\n"
|
|
|
|
#: c-api/veryhigh.rst:8
|
|
msgid "The Very High Level Layer"
|
|
msgstr ""
|
|
|
|
#: c-api/veryhigh.rst:10
|
|
msgid ""
|
|
"The functions in this chapter will let you execute Python source code given "
|
|
"in a file or a buffer, but they will not let you interact in a more detailed "
|
|
"way with the interpreter."
|
|
msgstr ""
|
|
|
|
#: c-api/veryhigh.rst:14
|
|
msgid ""
|
|
"Several of these functions accept a start symbol from the grammar as a "
|
|
"parameter. The available start symbols are :const:`Py_eval_input`, :const:"
|
|
"`Py_file_input`, and :const:`Py_single_input`. These are described "
|
|
"following the functions which accept them as parameters."
|
|
msgstr ""
|
|
|
|
#: c-api/veryhigh.rst:19
|
|
msgid ""
|
|
"Note also that several of these functions take :c:type:`FILE*` parameters. "
|
|
"One particular issue which needs to be handled carefully is that the :c:type:"
|
|
"`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 :c:type:`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."
|
|
msgstr ""
|
|
|
|
#: c-api/veryhigh.rst:30
|
|
msgid ""
|
|
"The main program for the standard interpreter. This is made available for "
|
|
"programs which embed Python. The *argc* and *argv* parameters should be "
|
|
"prepared exactly as those which are passed to a C program's :c:func:`main` "
|
|
"function (converted to wchar_t according to the user's locale). It is "
|
|
"important to note that the argument list may be modified (but the contents "
|
|
"of the strings pointed to by the argument list are not). The return value "
|
|
"will be ``0`` if the interpreter exits normally (i.e., without an "
|
|
"exception), ``1`` if the interpreter exits due to an exception, or ``2`` if "
|
|
"the parameter list does not represent a valid Python command line."
|
|
msgstr ""
|
|
|
|
#: c-api/veryhigh.rst:40
|
|
msgid ""
|
|
"Note that if an otherwise unhandled :exc:`SystemExit` is raised, this "
|
|
"function will not return ``1``, but exit the process, as long as "
|
|
"``Py_InspectFlag`` is not set."
|
|
msgstr ""
|
|
|
|
#: c-api/veryhigh.rst:47
|
|
msgid "Similar to :c:func:`Py_Main` but *argv* is an array of bytes strings."
|
|
msgstr ""
|
|
|
|
#: c-api/veryhigh.rst:54
|
|
msgid ""
|
|
"This is a simplified interface to :c:func:`PyRun_AnyFileExFlags` below, "
|
|
"leaving *closeit* set to ``0`` and *flags* set to ``NULL``."
|
|
msgstr ""
|
|
|
|
#: c-api/veryhigh.rst:60
|
|
msgid ""
|
|
"This is a simplified interface to :c:func:`PyRun_AnyFileExFlags` below, "
|
|
"leaving the *closeit* argument set to ``0``."
|
|
msgstr ""
|
|
|
|
#: c-api/veryhigh.rst:66
|
|
msgid ""
|
|
"This is a simplified interface to :c:func:`PyRun_AnyFileExFlags` below, "
|
|
"leaving the *flags* argument set to ``NULL``."
|
|
msgstr ""
|
|
|
|
#: c-api/veryhigh.rst:72
|
|
msgid ""
|
|
"If *fp* refers to a file associated with an interactive device (console or "
|
|
"terminal input or Unix pseudo-terminal), return the value of :c:func:"
|
|
"`PyRun_InteractiveLoop`, otherwise return the result of :c:func:"
|
|
"`PyRun_SimpleFile`. *filename* is decoded from the filesystem encoding (:"
|
|
"func:`sys.getfilesystemencoding`). If *filename* is ``NULL``, this function "
|
|
"uses ``\"???\"`` as the filename."
|
|
msgstr ""
|
|
|
|
#: c-api/veryhigh.rst:82
|
|
msgid ""
|
|
"This is a simplified interface to :c:func:`PyRun_SimpleStringFlags` below, "
|
|
"leaving the :c:type:`PyCompilerFlags`\\* argument set to ``NULL``."
|
|
msgstr ""
|
|
|
|
#: c-api/veryhigh.rst:88
|
|
msgid ""
|
|
"Executes the Python source code from *command* in the :mod:`__main__` module "
|
|
"according to the *flags* argument. If :mod:`__main__` does not already "
|
|
"exist, it is created. Returns ``0`` on success or ``-1`` if an exception "
|
|
"was raised. If there was an error, there is no way to get the exception "
|
|
"information. For the meaning of *flags*, see below."
|
|
msgstr ""
|
|
|
|
#: c-api/veryhigh.rst:94
|
|
msgid ""
|
|
"Note that if an otherwise unhandled :exc:`SystemExit` is raised, this "
|
|
"function will not return ``-1``, but exit the process, as long as "
|
|
"``Py_InspectFlag`` is not set."
|
|
msgstr ""
|
|
|
|
#: c-api/veryhigh.rst:101
|
|
msgid ""
|
|
"This is a simplified interface to :c:func:`PyRun_SimpleFileExFlags` below, "
|
|
"leaving *closeit* set to ``0`` and *flags* set to ``NULL``."
|
|
msgstr ""
|
|
|
|
#: c-api/veryhigh.rst:107
|
|
msgid ""
|
|
"This is a simplified interface to :c:func:`PyRun_SimpleFileExFlags` below, "
|
|
"leaving *flags* set to ``NULL``."
|
|
msgstr ""
|
|
|
|
#: c-api/veryhigh.rst:113
|
|
msgid ""
|
|
"Similar to :c:func:`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 (:func:`sys."
|
|
"getfilesystemencoding`). If *closeit* is true, the file is closed before "
|
|
"PyRun_SimpleFileExFlags returns."
|
|
msgstr ""
|
|
|
|
#: c-api/veryhigh.rst:120
|
|
msgid ""
|
|
"On Windows, *fp* should be opened as binary mode (e.g. ``fopen(filename, \"rb"
|
|
"\")``). Otherwise, Python may not handle script file with LF line ending "
|
|
"correctly."
|
|
msgstr ""
|
|
|
|
#: c-api/veryhigh.rst:126
|
|
msgid ""
|
|
"This is a simplified interface to :c:func:`PyRun_InteractiveOneFlags` below, "
|
|
"leaving *flags* set to ``NULL``."
|
|
msgstr ""
|
|
|
|
#: c-api/veryhigh.rst:132
|
|
msgid ""
|
|
"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`` and ``sys.ps2``. *filename* is decoded from the "
|
|
"filesystem encoding (:func:`sys.getfilesystemencoding`)."
|
|
msgstr ""
|
|
|
|
#: c-api/veryhigh.rst:137
|
|
msgid ""
|
|
"Returns ``0`` when the input was executed successfully, ``-1`` if there was "
|
|
"an exception, or an error code from the :file:`errcode.h` include file "
|
|
"distributed as part of Python if there was a parse error. (Note that :file:"
|
|
"`errcode.h` is not included by :file:`Python.h`, so must be included "
|
|
"specifically if needed.)"
|
|
msgstr ""
|
|
|
|
#: c-api/veryhigh.rst:146
|
|
msgid ""
|
|
"This is a simplified interface to :c:func:`PyRun_InteractiveLoopFlags` "
|
|
"below, leaving *flags* set to ``NULL``."
|
|
msgstr ""
|
|
|
|
#: c-api/veryhigh.rst:152
|
|
msgid ""
|
|
"Read and execute statements from a file associated with an interactive "
|
|
"device until EOF is reached. The user will be prompted using ``sys.ps1`` "
|
|
"and ``sys.ps2``. *filename* is decoded from the filesystem encoding (:func:"
|
|
"`sys.getfilesystemencoding`). Returns ``0`` at EOF or a negative number "
|
|
"upon failure."
|
|
msgstr ""
|
|
|
|
#: c-api/veryhigh.rst:161
|
|
msgid ""
|
|
"Can be set to point to a function with the prototype ``int func(void)``. "
|
|
"The function will be called when Python's interpreter prompt is about to "
|
|
"become idle and wait for user input from the terminal. The return value is "
|
|
"ignored. Overriding this hook can be used to integrate the interpreter's "
|
|
"prompt with other event loops, as done in the :file:`Modules/_tkinter.c` in "
|
|
"the Python source code."
|
|
msgstr ""
|
|
|
|
#: c-api/veryhigh.rst:172
|
|
msgid ""
|
|
"Can be set to point to a function with the prototype ``char *func(FILE "
|
|
"*stdin, FILE *stdout, char *prompt)``, overriding the default function used "
|
|
"to read a single line of input at the interpreter's prompt. The function is "
|
|
"expected to output the string *prompt* if it's not ``NULL``, and then read a "
|
|
"line of input from the provided standard input file, returning the resulting "
|
|
"string. For example, The :mod:`readline` module sets this hook to provide "
|
|
"line-editing and tab-completion features."
|
|
msgstr ""
|
|
|
|
#: c-api/veryhigh.rst:181
|
|
msgid ""
|
|
"The result must be a string allocated by :c:func:`PyMem_RawMalloc` or :c:"
|
|
"func:`PyMem_RawRealloc`, or ``NULL`` if an error occurred."
|
|
msgstr ""
|
|
|
|
#: c-api/veryhigh.rst:184
|
|
msgid ""
|
|
"The result must be allocated by :c:func:`PyMem_RawMalloc` or :c:func:"
|
|
"`PyMem_RawRealloc`, instead of being allocated by :c:func:`PyMem_Malloc` or :"
|
|
"c:func:`PyMem_Realloc`."
|
|
msgstr ""
|
|
|
|
#: c-api/veryhigh.rst:192
|
|
msgid ""
|
|
"This is a simplified interface to :c:func:"
|
|
"`PyParser_SimpleParseStringFlagsFilename` below, leaving *filename* set to "
|
|
"``NULL`` and *flags* set to ``0``."
|
|
msgstr ""
|
|
|
|
#: c-api/veryhigh.rst:201
|
|
msgid ""
|
|
"This is a simplified interface to :c:func:"
|
|
"`PyParser_SimpleParseStringFlagsFilename` below, leaving *filename* set to "
|
|
"``NULL``."
|
|
msgstr ""
|
|
|
|
#: c-api/veryhigh.rst:210
|
|
msgid ""
|
|
"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 "
|
|
"(:func:`sys.getfilesystemencoding`)."
|
|
msgstr ""
|
|
|
|
#: c-api/veryhigh.rst:221
|
|
msgid ""
|
|
"This is a simplified interface to :c:func:`PyParser_SimpleParseFileFlags` "
|
|
"below, leaving *flags* set to ``0``."
|
|
msgstr ""
|
|
|
|
#: c-api/veryhigh.rst:229
|
|
msgid ""
|
|
"Similar to :c:func:`PyParser_SimpleParseStringFlagsFilename`, but the Python "
|
|
"source code is read from *fp* instead of an in-memory string."
|
|
msgstr ""
|
|
|
|
#: c-api/veryhigh.rst:237
|
|
msgid ""
|
|
"This is a simplified interface to :c:func:`PyRun_StringFlags` below, leaving "
|
|
"*flags* set to ``NULL``."
|
|
msgstr ""
|
|
|
|
#: c-api/veryhigh.rst:243
|
|
msgid ""
|
|
"Execute Python source code from *str* in the context specified by the "
|
|
"objects *globals* and *locals* with the compiler flags specified by "
|
|
"*flags*. *globals* must be a dictionary; *locals* can be any object that "
|
|
"implements the mapping protocol. The parameter *start* specifies the start "
|
|
"token that should be used to parse the source code."
|
|
msgstr ""
|
|
|
|
#: c-api/veryhigh.rst:249
|
|
msgid ""
|
|
"Returns the result of executing the code as a Python object, or ``NULL`` if "
|
|
"an exception was raised."
|
|
msgstr ""
|
|
|
|
#: c-api/veryhigh.rst:255
|
|
msgid ""
|
|
"This is a simplified interface to :c:func:`PyRun_FileExFlags` below, leaving "
|
|
"*closeit* set to ``0`` and *flags* set to ``NULL``."
|
|
msgstr ""
|
|
|
|
#: c-api/veryhigh.rst:261
|
|
msgid ""
|
|
"This is a simplified interface to :c:func:`PyRun_FileExFlags` below, leaving "
|
|
"*flags* set to ``NULL``."
|
|
msgstr ""
|
|
|
|
#: c-api/veryhigh.rst:267
|
|
msgid ""
|
|
"This is a simplified interface to :c:func:`PyRun_FileExFlags` below, leaving "
|
|
"*closeit* set to ``0``."
|
|
msgstr ""
|
|
|
|
#: c-api/veryhigh.rst:273
|
|
msgid ""
|
|
"Similar to :c:func:`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 (:func:`sys."
|
|
"getfilesystemencoding`). If *closeit* is true, the file is closed before :c:"
|
|
"func:`PyRun_FileExFlags` returns."
|
|
msgstr ""
|
|
|
|
#: c-api/veryhigh.rst:282
|
|
msgid ""
|
|
"This is a simplified interface to :c:func:`Py_CompileStringFlags` below, "
|
|
"leaving *flags* set to ``NULL``."
|
|
msgstr ""
|
|
|
|
#: c-api/veryhigh.rst:288
|
|
msgid ""
|
|
"This is a simplified interface to :c:func:`Py_CompileStringExFlags` below, "
|
|
"with *optimize* set to ``-1``."
|
|
msgstr ""
|
|
|
|
#: c-api/veryhigh.rst:294
|
|
msgid ""
|
|
"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 :const:"
|
|
"`Py_eval_input`, :const:`Py_file_input`, or :const:`Py_single_input`. The "
|
|
"filename specified by *filename* is used to construct the code object and "
|
|
"may appear in tracebacks or :exc:`SyntaxError` exception messages. This "
|
|
"returns ``NULL`` if the code cannot be parsed or compiled."
|
|
msgstr ""
|
|
|
|
#: c-api/veryhigh.rst:302
|
|
msgid ""
|
|
"The integer *optimize* specifies the optimization level of the compiler; a "
|
|
"value of ``-1`` selects the optimization level of the interpreter as given "
|
|
"by :option:`-O` options. Explicit levels are ``0`` (no optimization; "
|
|
"``__debug__`` is true), ``1`` (asserts are removed, ``__debug__`` is false) "
|
|
"or ``2`` (docstrings are removed too)."
|
|
msgstr ""
|
|
|
|
#: c-api/veryhigh.rst:313
|
|
msgid ""
|
|
"Like :c:func:`Py_CompileStringObject`, but *filename* is a byte string "
|
|
"decoded from the filesystem encoding (:func:`os.fsdecode`)."
|
|
msgstr ""
|
|
|
|
#: c-api/veryhigh.rst:320
|
|
msgid ""
|
|
"This is a simplified interface to :c:func:`PyEval_EvalCodeEx`, with just the "
|
|
"code object, and global and local variables. The other arguments are set to "
|
|
"``NULL``."
|
|
msgstr ""
|
|
|
|
#: c-api/veryhigh.rst:327
|
|
msgid ""
|
|
"Evaluate a precompiled code object, given a particular environment for its "
|
|
"evaluation. This environment consists of a dictionary of global variables, "
|
|
"a mapping object of local variables, arrays of arguments, keywords and "
|
|
"defaults, a dictionary of default values for :ref:`keyword-only <keyword-"
|
|
"only_parameter>` arguments and a closure tuple of cells."
|
|
msgstr ""
|
|
|
|
#: c-api/veryhigh.rst:336
|
|
#, fuzzy
|
|
msgid ""
|
|
"The C structure of the objects used to describe frame objects. The fields of "
|
|
"this type are subject to change at any time."
|
|
msgstr ""
|
|
"La structure C utilisée pour décrire les objets *Code*. Les attributs de "
|
|
"cette structure sont sujets à changer à tout moment."
|
|
|
|
#: c-api/veryhigh.rst:342
|
|
msgid ""
|
|
"Evaluate an execution frame. This is a simplified interface to :c:func:"
|
|
"`PyEval_EvalFrameEx`, for backward compatibility."
|
|
msgstr ""
|
|
|
|
#: c-api/veryhigh.rst:348
|
|
msgid ""
|
|
"This is the main, unvarnished function of Python interpretation. The code "
|
|
"object associated with the execution frame *f* is executed, interpreting "
|
|
"bytecode and executing calls as needed. The additional *throwflag* "
|
|
"parameter can mostly be ignored - if true, then it causes an exception to "
|
|
"immediately be thrown; this is used for the :meth:`~generator.throw` methods "
|
|
"of generator objects."
|
|
msgstr ""
|
|
|
|
#: c-api/veryhigh.rst:355
|
|
msgid ""
|
|
"This function now includes a debug assertion to help ensure that it does not "
|
|
"silently discard an active exception."
|
|
msgstr ""
|
|
"Cette fonction inclut maintenant une assertion de débogage afin d'assurer "
|
|
"qu'elle ne passe pas sous silence une exception active."
|
|
|
|
#: c-api/veryhigh.rst:362
|
|
msgid ""
|
|
"This function changes the flags of the current evaluation frame, and returns "
|
|
"true on success, false on failure."
|
|
msgstr ""
|
|
|
|
#: c-api/veryhigh.rst:370
|
|
msgid ""
|
|
"The start symbol from the Python grammar for isolated expressions; for use "
|
|
"with :c:func:`Py_CompileString`."
|
|
msgstr ""
|
|
|
|
#: c-api/veryhigh.rst:378
|
|
msgid ""
|
|
"The start symbol from the Python grammar for sequences of statements as read "
|
|
"from a file or other source; for use with :c:func:`Py_CompileString`. This "
|
|
"is the symbol to use when compiling arbitrarily long Python source code."
|
|
msgstr ""
|
|
|
|
#: c-api/veryhigh.rst:387
|
|
msgid ""
|
|
"The start symbol from the Python grammar for a single statement; for use "
|
|
"with :c:func:`Py_CompileString`. This is the symbol used for the interactive "
|
|
"interpreter loop."
|
|
msgstr ""
|
|
|
|
#: c-api/veryhigh.rst:394
|
|
msgid ""
|
|
"This is the structure used to hold compiler flags. In cases where code is "
|
|
"only being compiled, it is passed as ``int flags``, and in cases where code "
|
|
"is being executed, it is passed as ``PyCompilerFlags *flags``. In this "
|
|
"case, ``from __future__ import`` can modify *flags*."
|
|
msgstr ""
|
|
|
|
#: c-api/veryhigh.rst:399
|
|
msgid ""
|
|
"Whenever ``PyCompilerFlags *flags`` is ``NULL``, :attr:`cf_flags` is treated "
|
|
"as equal to ``0``, and any modification due to ``from __future__ import`` is "
|
|
"discarded."
|
|
msgstr ""
|
|
|
|
#: c-api/veryhigh.rst:405
|
|
msgid "Compiler flags."
|
|
msgstr ""
|
|
|
|
#: c-api/veryhigh.rst:409
|
|
msgid ""
|
|
"*cf_feature_version* is the minor Python version. It should be initialized "
|
|
"to ``PY_MINOR_VERSION``."
|
|
msgstr ""
|
|
|
|
#: c-api/veryhigh.rst:412
|
|
msgid ""
|
|
"The field is ignored by default, it is used if and only if ``PyCF_ONLY_AST`` "
|
|
"flag is set in *cf_flags*."
|
|
msgstr ""
|
|
|
|
#: c-api/veryhigh.rst:415
|
|
msgid "Added *cf_feature_version* field."
|
|
msgstr ""
|
|
|
|
#: c-api/veryhigh.rst:421
|
|
msgid ""
|
|
"This bit can be set in *flags* to cause division operator ``/`` to be "
|
|
"interpreted as \"true division\" according to :pep:`238`."
|
|
msgstr ""
|