# 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 \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 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:" "type:`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:type:`void (\\*)(int)`." msgstr "" #: c-api/sys.rst:121 msgid "" "Decode a byte string from the locale encoding with the :ref:`surrogateescape " "error handler `: undecodable bytes are decoded as " "characters in range U+DC80..U+DCFF. If a byte sequence can be decoded as a " "surrogate character, escape the bytes using the surrogateescape error " "handler instead of decoding them." msgstr "" #: c-api/sys.rst:127 c-api/sys.rst:173 msgid "Encoding, highest priority to lowest priority:" msgstr "" #: c-api/sys.rst:129 c-api/sys.rst:175 msgid "``UTF-8`` on macOS, Android, and VxWorks;" msgstr "" #: c-api/sys.rst:130 c-api/sys.rst:176 msgid "" "``UTF-8`` on Windows if :c:data:`Py_LegacyWindowsFSEncodingFlag` is zero;" msgstr "" #: c-api/sys.rst:131 c-api/sys.rst:177 msgid "``UTF-8`` if the Python UTF-8 mode is enabled;" msgstr "" #: c-api/sys.rst:132 c-api/sys.rst:178 msgid "" "``ASCII`` if the ``LC_CTYPE`` locale is ``\"C\"``, ``nl_langinfo(CODESET)`` " "returns the ``ASCII`` encoding (or an alias), and :c:func:`mbstowcs` and :c:" "func:`wcstombs` functions uses the ``ISO-8859-1`` encoding." msgstr "" #: c-api/sys.rst:136 c-api/sys.rst:182 msgid "the current locale encoding." msgstr "" #: c-api/sys.rst:138 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:142 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:146 msgid "" "Decoding errors should never happen, unless there is a bug in the C library." msgstr "" #: c-api/sys.rst:149 msgid "" "Use the :c:func:`Py_EncodeLocale` function to encode the character string " "back to a byte string." msgstr "" #: c-api/sys.rst:154 msgid "" "The :c:func:`PyUnicode_DecodeFSDefaultAndSize` and :c:func:" "`PyUnicode_DecodeLocaleAndSize` functions." msgstr "" #: c-api/sys.rst:159 c-api/sys.rst:203 msgid "The function now uses the UTF-8 encoding in the UTF-8 mode." msgstr "" #: c-api/sys.rst:162 c-api/sys.rst:206 msgid "" "The function now uses the UTF-8 encoding on Windows if :c:data:" "`Py_LegacyWindowsFSEncodingFlag` is zero;" msgstr "" #: c-api/sys.rst:169 msgid "" "Encode a wide character string to the locale encoding with the :ref:" "`surrogateescape error handler `: surrogate characters in " "the range U+DC80..U+DCFF are converted to bytes 0x80..0xFF." msgstr "" #: c-api/sys.rst:184 msgid "The function uses the UTF-8 encoding in the Python UTF-8 mode." msgstr "" #: c-api/sys.rst:186 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:190 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:193 msgid "" "Use the :c:func:`Py_DecodeLocale` function to decode the bytes string back " "to a wide character string." msgstr "" #: c-api/sys.rst:198 msgid "" "The :c:func:`PyUnicode_EncodeFSDefault` and :c:func:`PyUnicode_EncodeLocale` " "functions." msgstr "" #: c-api/sys.rst:214 msgid "System Functions" msgstr "" #: c-api/sys.rst:216 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:222 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:227 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:233 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:238 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:243 msgid "Append *unicode* to :data:`sys.warnoptions`." msgstr "" #: c-api/sys.rst:245 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:253 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:259 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:262 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:270 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:275 msgid "" "As :c:func:`PySys_WriteStdout`, but write to :data:`sys.stderr` or *stderr* " "instead." msgstr "" #: c-api/sys.rst:280 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:288 msgid "" "As :c:func:`PySys_FormatStdout`, but write to :data:`sys.stderr` or *stderr* " "instead." msgstr "" #: c-api/sys.rst:295 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:303 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:312 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:315 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:323 msgid "" "Note that ``#`` format characters should always be treated as " "``Py_ssize_t``, regardless of whether ``PY_SSIZE_T_CLEAN`` was defined." msgstr "" #: c-api/sys.rst:326 msgid ":func:`sys.audit` performs the same function from Python code." msgstr "" #: c-api/sys.rst:332 msgid "" "Require ``Py_ssize_t`` for ``#`` format characters. Previously, an " "unavoidable deprecation warning was raised." msgstr "" #: c-api/sys.rst:338 msgid "" "Append the callable *hook* to the list of active auditing hooks. Return zero " "for 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:344 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:348 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:353 msgid "" "The hook function is of type :c:type:`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:358 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:None 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:365 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:377 msgid "Process Control" msgstr "" #: c-api/sys.rst:384 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:391 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:395 msgid "Log the function name automatically." msgstr "" #: c-api/sys.rst:405 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:409 msgid "Errors from finalization no longer ignored." msgstr "" #: c-api/sys.rst:419 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 ""