# 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: 2023-01-15 22:33+0100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: FRENCH \n" "Language: fr\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" #: c-api/sys.rst:6 msgid "Operating System Utilities" msgstr "" #: c-api/sys.rst:10 msgid "" "Return the file system representation for *path*. If the object is a :class:" "`str` or :class:`bytes` object, then its reference count is incremented. If " "the object implements the :class:`os.PathLike` interface, then :meth:`~os." "PathLike.__fspath__` is returned as long as it is a :class:`str` or :class:" "`bytes` object. Otherwise :exc:`TypeError` is raised and ``NULL`` is " "returned." msgstr "" #: c-api/sys.rst:22 msgid "" "Return true (nonzero) if the standard I/O file *fp* with name *filename* is " "deemed interactive. This is the case for files for which " "``isatty(fileno(fp))`` is true. If the global flag :c:data:" "`Py_InteractiveFlag` is true, this function also returns true if the " "*filename* pointer is ``NULL`` or if the name is equal to one of the strings " "``''`` or ``'???'``." msgstr "" #: c-api/sys.rst:31 msgid "" "Function to prepare some internal state before a process fork. This should " "be called before calling :c:func:`fork` or any similar function that clones " "the current process. Only available on systems where :c:func:`fork` is " "defined." msgstr "" #: c-api/sys.rst:37 msgid "" "The C :c:func:`fork` call should only be made from the :ref:`\"main\" thread " "` (of the :ref:`\"main\" interpreter `). The same is true for ``PyOS_BeforeFork()``." msgstr "" #: c-api/sys.rst:47 msgid "" "Function to update some internal state after a process fork. This should be " "called from the parent process after calling :c:func:`fork` or any similar " "function that clones the current process, regardless of whether process " "cloning was successful. Only available on systems where :c:func:`fork` is " "defined." msgstr "" #: c-api/sys.rst:54 msgid "" "The C :c:func:`fork` call should only be made from the :ref:`\"main\" thread " "` (of the :ref:`\"main\" interpreter `). The same is true for ``PyOS_AfterFork_Parent()``." msgstr "" #: c-api/sys.rst:64 msgid "" "Function to update internal interpreter state after a process fork. This " "must be called from the child process after calling :c:func:`fork`, or any " "similar function that clones the current process, if there is any chance the " "process will call back into the Python interpreter. Only available on " "systems where :c:func:`fork` is defined." msgstr "" #: c-api/sys.rst:71 msgid "" "The C :c:func:`fork` call should only be made from the :ref:`\"main\" thread " "` (of the :ref:`\"main\" interpreter `). The same is true for ``PyOS_AfterFork_Child()``." msgstr "" #: c-api/sys.rst:79 msgid "" ":func:`os.register_at_fork` allows registering custom Python functions to be " "called by :c:func:`PyOS_BeforeFork()`, :c:func:`PyOS_AfterFork_Parent` and :" "c:func:`PyOS_AfterFork_Child`." msgstr "" #: c-api/sys.rst:86 msgid "" "Function to update some internal state after a process fork; this should be " "called in the new process if the Python interpreter will continue to be " "used. If a new executable is loaded into the new process, this function does " "not need to be called." msgstr "" #: c-api/sys.rst:91 msgid "This function is superseded by :c:func:`PyOS_AfterFork_Child()`." msgstr "" #: c-api/sys.rst:97 msgid "" "Return true when the interpreter runs out of stack space. This is a " "reliable check, but is only available when :const:`USE_STACKCHECK` is " "defined (currently on certain versions of Windows using the Microsoft Visual " "C++ compiler). :const:`USE_STACKCHECK` will be defined automatically; you " "should never change the definition in your own code." msgstr "" #: c-api/sys.rst:106 msgid "" "Return the current signal handler for signal *i*. This is a thin wrapper " "around either :c:func:`sigaction` or :c:func:`signal`. Do not call those " "functions directly! :c:type:`PyOS_sighandler_t` is a typedef alias for :c:" "expr:`void (\\*)(int)`." msgstr "" #: c-api/sys.rst:114 msgid "" "Set the signal handler for signal *i* to be *h*; return the old signal " "handler. This is a thin wrapper around either :c:func:`sigaction` or :c:func:" "`signal`. Do not call those functions directly! :c:type:" "`PyOS_sighandler_t` is a typedef alias for :c:expr:`void (\\*)(int)`." msgstr "" #: c-api/sys.rst:122 msgid "" "This function should not be called directly: use the :c:type:`PyConfig` API " "with the :c:func:`PyConfig_SetBytesString` function which ensures that :ref:" "`Python is preinitialized `." msgstr "" #: c-api/sys.rst:193 msgid "" "This function must not be called before :ref:`Python is preinitialized ` and so that the LC_CTYPE locale is properly configured: see the :c:" "func:`Py_PreInitialize` function." msgstr "" #: c-api/sys.rst:130 msgid "" "Decode a byte string from the :term:`filesystem encoding and error handler`. " "If the error handler is :ref:`surrogateescape error handler " "`, undecodable bytes are decoded as characters in range " "U+DC80..U+DCFF; and if a byte sequence can be decoded as a surrogate " "character, the bytes are escaped using the surrogateescape error handler " "instead of decoding them." msgstr "" #: c-api/sys.rst:137 msgid "" "Return a pointer to a newly allocated wide character string, use :c:func:" "`PyMem_RawFree` to free the memory. If size is not ``NULL``, write the " "number of wide characters excluding the null character into ``*size``" msgstr "" #: c-api/sys.rst:141 msgid "" "Return ``NULL`` on decoding error or memory allocation error. If *size* is " "not ``NULL``, ``*size`` is set to ``(size_t)-1`` on memory error or set to " "``(size_t)-2`` on decoding error." msgstr "" #: c-api/sys.rst:185 msgid "" "The :term:`filesystem encoding and error handler` are selected by :c:func:" "`PyConfig_Read`: see :c:member:`~PyConfig.filesystem_encoding` and :c:member:" "`~PyConfig.filesystem_errors` members of :c:type:`PyConfig`." msgstr "" #: c-api/sys.rst:149 msgid "" "Decoding errors should never happen, unless there is a bug in the C library." msgstr "" #: c-api/sys.rst:152 msgid "" "Use the :c:func:`Py_EncodeLocale` function to encode the character string " "back to a byte string." msgstr "" #: c-api/sys.rst:157 msgid "" "The :c:func:`PyUnicode_DecodeFSDefaultAndSize` and :c:func:" "`PyUnicode_DecodeLocaleAndSize` functions." msgstr "" #: c-api/sys.rst:204 msgid "" "The function now uses the UTF-8 encoding in the :ref:`Python UTF-8 Mode " "`." msgstr "" #: c-api/sys.rst:166 msgid "" "The function now uses the UTF-8 encoding on Windows if :c:data:" "`Py_LegacyWindowsFSEncodingFlag` is zero;" msgstr "" #: c-api/sys.rst:173 msgid "" "Encode a wide character string to the :term:`filesystem encoding and error " "handler`. If the error handler is :ref:`surrogateescape error handler " "`, surrogate characters in the range U+DC80..U+DCFF are " "converted to bytes 0x80..0xFF." msgstr "" #: c-api/sys.rst:178 msgid "" "Return a pointer to a newly allocated byte string, use :c:func:`PyMem_Free` " "to free the memory. Return ``NULL`` on encoding error or memory allocation " "error." msgstr "" #: c-api/sys.rst:182 msgid "" "If error_pos is not ``NULL``, ``*error_pos`` is set to ``(size_t)-1`` on " "success, or set to the index of the invalid character on encoding error." msgstr "" #: c-api/sys.rst:189 msgid "" "Use the :c:func:`Py_DecodeLocale` function to decode the bytes string back " "to a wide character string." msgstr "" #: c-api/sys.rst:199 msgid "" "The :c:func:`PyUnicode_EncodeFSDefault` and :c:func:`PyUnicode_EncodeLocale` " "functions." msgstr "" #: c-api/sys.rst:208 msgid "" "The function now uses the UTF-8 encoding on Windows if :c:data:" "`Py_LegacyWindowsFSEncodingFlag` is zero." msgstr "" #: c-api/sys.rst:216 msgid "System Functions" msgstr "" #: c-api/sys.rst:218 msgid "" "These are utility functions that make functionality from the :mod:`sys` " "module accessible to C code. They all work with the current interpreter " "thread's :mod:`sys` module's dict, which is contained in the internal thread " "state structure." msgstr "" #: c-api/sys.rst:224 msgid "" "Return the object *name* from the :mod:`sys` module or ``NULL`` if it does " "not exist, without setting an exception." msgstr "" #: c-api/sys.rst:229 msgid "" "Set *name* in the :mod:`sys` module to *v* unless *v* is ``NULL``, in which " "case *name* is deleted from the sys module. Returns ``0`` on success, ``-1`` " "on error." msgstr "" #: c-api/sys.rst:235 msgid "" "Reset :data:`sys.warnoptions` to an empty list. This function may be called " "prior to :c:func:`Py_Initialize`." msgstr "" #: c-api/sys.rst:251 msgid "" "This API is kept for backward compatibility: setting :c:member:`PyConfig." "warnoptions` should be used instead, see :ref:`Python Initialization " "Configuration `." msgstr "" #: c-api/sys.rst:244 msgid "" "Append *s* to :data:`sys.warnoptions`. This function must be called prior " "to :c:func:`Py_Initialize` in order to affect the warnings filter list." msgstr "" #: c-api/sys.rst:255 msgid "Append *unicode* to :data:`sys.warnoptions`." msgstr "" #: c-api/sys.rst:257 msgid "" "Note: this function is not currently usable from outside the CPython " "implementation, as it must be called prior to the implicit import of :mod:" "`warnings` in :c:func:`Py_Initialize` to be effective, but can't be called " "until enough of the runtime has been initialized to permit the creation of " "Unicode objects." msgstr "" #: c-api/sys.rst:267 msgid "" "This API is kept for backward compatibility: setting :c:member:`PyConfig." "module_search_paths` and :c:member:`PyConfig.module_search_paths_set` should " "be used instead, see :ref:`Python Initialization Configuration `." msgstr "" #: c-api/sys.rst:272 msgid "" "Set :data:`sys.path` to a list object of paths found in *path* which should " "be a list of paths separated with the platform's search path delimiter (``:" "`` on Unix, ``;`` on Windows)." msgstr "" #: c-api/sys.rst:280 msgid "" "Write the output string described by *format* to :data:`sys.stdout`. No " "exceptions are raised, even if truncation occurs (see below)." msgstr "" #: c-api/sys.rst:283 msgid "" "*format* should limit the total size of the formatted output string to 1000 " "bytes or less -- after 1000 bytes, the output string is truncated. In " "particular, this means that no unrestricted \"%s\" formats should occur; " "these should be limited using \"%.s\" where is a decimal number " "calculated so that plus the maximum size of other formatted text does " "not exceed 1000 bytes. Also watch out for \"%f\", which can print hundreds " "of digits for very large numbers." msgstr "" #: c-api/sys.rst:291 msgid "" "If a problem occurs, or :data:`sys.stdout` is unset, the formatted message " "is written to the real (C level) *stdout*." msgstr "" #: c-api/sys.rst:296 msgid "" "As :c:func:`PySys_WriteStdout`, but write to :data:`sys.stderr` or *stderr* " "instead." msgstr "" #: c-api/sys.rst:301 msgid "" "Function similar to PySys_WriteStdout() but format the message using :c:func:" "`PyUnicode_FromFormatV` and don't truncate the message to an arbitrary " "length." msgstr "" #: c-api/sys.rst:309 msgid "" "As :c:func:`PySys_FormatStdout`, but write to :data:`sys.stderr` or *stderr* " "instead." msgstr "" #: c-api/sys.rst:316 msgid "" "This API is kept for backward compatibility: setting :c:member:`PyConfig." "xoptions` should be used instead, see :ref:`Python Initialization " "Configuration `." msgstr "" #: c-api/sys.rst:320 msgid "" "Parse *s* as a set of :option:`-X` options and add them to the current " "options mapping as returned by :c:func:`PySys_GetXOptions`. This function " "may be called prior to :c:func:`Py_Initialize`." msgstr "" #: c-api/sys.rst:330 msgid "" "Return the current dictionary of :option:`-X` options, similarly to :data:" "`sys._xoptions`. On error, ``NULL`` is returned and an exception is set." msgstr "" #: c-api/sys.rst:339 msgid "" "Raise an auditing event with any active hooks. Return zero for success and " "non-zero with an exception set on failure." msgstr "" #: c-api/sys.rst:342 msgid "" "If any hooks have been added, *format* and other arguments will be used to " "construct a tuple to pass. Apart from ``N``, the same format characters as " "used in :c:func:`Py_BuildValue` are available. If the built value is not a " "tuple, it will be added into a single-element tuple. (The ``N`` format " "option consumes a reference, but since there is no way to know whether " "arguments to this function will be consumed, using it may cause reference " "leaks.)" msgstr "" #: c-api/sys.rst:350 msgid "" "Note that ``#`` format characters should always be treated as :c:type:" "`Py_ssize_t`, regardless of whether ``PY_SSIZE_T_CLEAN`` was defined." msgstr "" #: c-api/sys.rst:353 msgid ":func:`sys.audit` performs the same function from Python code." msgstr "" #: c-api/sys.rst:359 msgid "" "Require :c:type:`Py_ssize_t` for ``#`` format characters. Previously, an " "unavoidable deprecation warning was raised." msgstr "" #: c-api/sys.rst:365 msgid "" "Append the callable *hook* to the list of active auditing hooks. Return zero " "on success and non-zero on failure. If the runtime has been initialized, " "also set an error on failure. Hooks added through this API are called for " "all interpreters created by the runtime." msgstr "" #: c-api/sys.rst:371 msgid "" "The *userData* pointer is passed into the hook function. Since hook " "functions may be called from different runtimes, this pointer should not " "refer directly to Python state." msgstr "" #: c-api/sys.rst:375 msgid "" "This function is safe to call before :c:func:`Py_Initialize`. When called " "after runtime initialization, existing audit hooks are notified and may " "silently abort the operation by raising an error subclassed from :class:" "`Exception` (other errors will not be silenced)." msgstr "" #: c-api/sys.rst:380 msgid "" "The hook function is of type :c:expr:`int (*)(const char *event, PyObject " "*args, void *userData)`, where *args* is guaranteed to be a :c:type:" "`PyTupleObject`. The hook function is always called with the GIL held by the " "Python interpreter that raised the event." msgstr "" #: c-api/sys.rst:385 msgid "" "See :pep:`578` for a detailed description of auditing. Functions in the " "runtime and standard library that raise events are listed in the :ref:`audit " "events table `. Details are in each function's documentation." msgstr "" #: c-api/sys.rst:390 msgid "" "Raises an :ref:`auditing event ` ``sys.addaudithook`` with no " "arguments." msgstr "" "Déclenche un :ref:`événement d'audit ` ``sys.addaudithook`` sans " "arguments." #: c-api/sys.rst:392 msgid "" "If the interpreter is initialized, this function raises a auditing event " "``sys.addaudithook`` with no arguments. If any existing hooks raise an " "exception derived from :class:`Exception`, the new hook will not be added " "and the exception is cleared. As a result, callers cannot assume that their " "hook has been added unless they control all existing hooks." msgstr "" #: c-api/sys.rst:404 msgid "Process Control" msgstr "" #: c-api/sys.rst:411 msgid "" "Print a fatal error message and kill the process. No cleanup is performed. " "This function should only be invoked when a condition is detected that would " "make it dangerous to continue using the Python interpreter; e.g., when the " "object administration appears to be corrupted. On Unix, the standard C " "library function :c:func:`abort` is called which will attempt to produce a :" "file:`core` file." msgstr "" #: c-api/sys.rst:418 msgid "" "The ``Py_FatalError()`` function is replaced with a macro which logs " "automatically the name of the current function, unless the " "``Py_LIMITED_API`` macro is defined." msgstr "" #: c-api/sys.rst:422 msgid "Log the function name automatically." msgstr "" #: c-api/sys.rst:432 msgid "" "Exit the current process. This calls :c:func:`Py_FinalizeEx` and then calls " "the standard C library function ``exit(status)``. If :c:func:" "`Py_FinalizeEx` indicates an error, the exit status is set to 120." msgstr "" #: c-api/sys.rst:436 msgid "Errors from finalization no longer ignored." msgstr "" #: c-api/sys.rst:446 msgid "" "Register a cleanup function to be called by :c:func:`Py_FinalizeEx`. The " "cleanup function will be called with no arguments and should return no " "value. At most 32 cleanup functions can be registered. When the " "registration is successful, :c:func:`Py_AtExit` returns ``0``; on failure, " "it returns ``-1``. The cleanup function registered last is called first. " "Each cleanup function will be called at most once. Since Python's internal " "finalization will have completed before the cleanup function, no Python APIs " "should be called by *func*." msgstr ""