# 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" #: library/mmap.rst:2 msgid ":mod:`mmap` --- Memory-mapped file support" msgstr "" #: includes/wasm-notavail.rst:None msgid ":ref:`Availability `: not Emscripten, not WASI." msgstr "" #: includes/wasm-notavail.rst:5 msgid "" "This module does not work or is not available on WebAssembly platforms " "``wasm32-emscripten`` and ``wasm32-wasi``. See :ref:`wasm-availability` for " "more information." msgstr "" #: library/mmap.rst:11 msgid "" "Memory-mapped file objects behave like both :class:`bytearray` and like :" "term:`file objects `. You can use mmap objects in most places " "where :class:`bytearray` are expected; for example, you can use the :mod:" "`re` module to search through a memory-mapped file. You can also change a " "single byte by doing ``obj[index] = 97``, or change a subsequence by " "assigning to a slice: ``obj[i1:i2] = b'...'``. You can also read and write " "data starting at the current file position, and :meth:`seek` through the " "file to different positions." msgstr "" #: library/mmap.rst:19 msgid "" "A memory-mapped file is created by the :class:`~mmap.mmap` constructor, " "which is different on Unix and on Windows. In either case you must provide " "a file descriptor for a file opened for update. If you wish to map an " "existing Python file object, use its :meth:`fileno` method to obtain the " "correct value for the *fileno* parameter. Otherwise, you can open the file " "using the :func:`os.open` function, which returns a file descriptor directly " "(the file still needs to be closed when done)." msgstr "" #: library/mmap.rst:28 msgid "" "If you want to create a memory-mapping for a writable, buffered file, you " "should :func:`~io.IOBase.flush` the file first. This is necessary to ensure " "that local modifications to the buffers are actually available to the " "mapping." msgstr "" #: library/mmap.rst:33 msgid "" "For both the Unix and Windows versions of the constructor, *access* may be " "specified as an optional keyword parameter. *access* accepts one of four " "values: :const:`ACCESS_READ`, :const:`ACCESS_WRITE`, or :const:`ACCESS_COPY` " "to specify read-only, write-through or copy-on-write memory respectively, " "or :const:`ACCESS_DEFAULT` to defer to *prot*. *access* can be used on both " "Unix and Windows. If *access* is not specified, Windows mmap returns a " "write-through mapping. The initial memory values for all three access types " "are taken from the specified file. Assignment to an :const:`ACCESS_READ` " "memory map raises a :exc:`TypeError` exception. Assignment to an :const:" "`ACCESS_WRITE` memory map affects both memory and the underlying file. " "Assignment to an :const:`ACCESS_COPY` memory map affects memory but does not " "update the underlying file." msgstr "" #: library/mmap.rst:46 msgid "Added :const:`ACCESS_DEFAULT` constant." msgstr "" #: library/mmap.rst:49 msgid "" "To map anonymous memory, -1 should be passed as the fileno along with the " "length." msgstr "" #: library/mmap.rst:53 msgid "" "**(Windows version)** Maps *length* bytes from the file specified by the " "file handle *fileno*, and creates a mmap object. If *length* is larger than " "the current size of the file, the file is extended to contain *length* " "bytes. If *length* is ``0``, the maximum length of the map is the current " "size of the file, except that if the file is empty Windows raises an " "exception (you cannot create an empty mapping on Windows)." msgstr "" #: library/mmap.rst:60 msgid "" "*tagname*, if specified and not ``None``, is a string giving a tag name for " "the mapping. Windows allows you to have many different mappings against the " "same file. If you specify the name of an existing tag, that tag is opened, " "otherwise a new tag of this name is created. If this parameter is omitted " "or ``None``, the mapping is created without a name. Avoiding the use of the " "tag parameter will assist in keeping your code portable between Unix and " "Windows." msgstr "" #: library/mmap.rst:68 msgid "" "*offset* may be specified as a non-negative integer offset. mmap references " "will be relative to the offset from the beginning of the file. *offset* " "defaults to 0. *offset* must be a multiple of the :const:" "`ALLOCATIONGRANULARITY`." msgstr "" #: library/mmap.rst:172 msgid "" "Raises an :ref:`auditing event ` ``mmap.__new__`` with arguments " "``fileno``, ``length``, ``access``, ``offset``." msgstr "" #: library/mmap.rst:77 msgid "" "**(Unix version)** Maps *length* bytes from the file specified by the file " "descriptor *fileno*, and returns a mmap object. If *length* is ``0``, the " "maximum length of the map will be the current size of the file when :class:" "`~mmap.mmap` is called." msgstr "" #: library/mmap.rst:82 msgid "" "*flags* specifies the nature of the mapping. :const:`MAP_PRIVATE` creates a " "private copy-on-write mapping, so changes to the contents of the mmap object " "will be private to this process, and :const:`MAP_SHARED` creates a mapping " "that's shared with all other processes mapping the same areas of the file. " "The default value is :const:`MAP_SHARED`. Some systems have additional " "possible flags with the full list specified in :ref:`MAP_* constants `." msgstr "" #: library/mmap.rst:90 msgid "" "*prot*, if specified, gives the desired memory protection; the two most " "useful values are :const:`PROT_READ` and :const:`PROT_WRITE`, to specify " "that the pages may be read or written. *prot* defaults to :const:`PROT_READ " "\\| PROT_WRITE`." msgstr "" #: library/mmap.rst:95 msgid "" "*access* may be specified in lieu of *flags* and *prot* as an optional " "keyword parameter. It is an error to specify both *flags*, *prot* and " "*access*. See the description of *access* above for information on how to " "use this parameter." msgstr "" #: library/mmap.rst:100 msgid "" "*offset* may be specified as a non-negative integer offset. mmap references " "will be relative to the offset from the beginning of the file. *offset* " "defaults to 0. *offset* must be a multiple of :const:`ALLOCATIONGRANULARITY` " "which is equal to :const:`PAGESIZE` on Unix systems." msgstr "" #: library/mmap.rst:105 msgid "" "To ensure validity of the created memory mapping the file specified by the " "descriptor *fileno* is internally automatically synchronized with the " "physical backing store on macOS." msgstr "" #: library/mmap.rst:109 msgid "This example shows a simple way of using :class:`~mmap.mmap`::" msgstr "" #: library/mmap.rst:134 msgid "" ":class:`~mmap.mmap` can also be used as a context manager in a :keyword:" "`with` statement::" msgstr "" #: library/mmap.rst:142 msgid "Context manager support." msgstr "" #: library/mmap.rst:146 msgid "" "The next example demonstrates how to create an anonymous map and exchange " "data between the parent and child processes::" msgstr "" #: library/mmap.rst:165 msgid "Memory-mapped file objects support the following methods:" msgstr "" #: library/mmap.rst:169 msgid "" "Closes the mmap. Subsequent calls to other methods of the object will result " "in a ValueError exception being raised. This will not close the open file." msgstr "" #: library/mmap.rst:176 msgid "``True`` if the file is closed." msgstr "" #: library/mmap.rst:183 msgid "" "Returns the lowest index in the object where the subsequence *sub* is found, " "such that *sub* is contained in the range [*start*, *end*]. Optional " "arguments *start* and *end* are interpreted as in slice notation. Returns " "``-1`` on failure." msgstr "" #: library/mmap.rst:277 library/mmap.rst:309 msgid "Writable :term:`bytes-like object` is now accepted." msgstr "N'importe quel :term:`bytes-like object` est maintenant accepté." #: library/mmap.rst:194 msgid "" "Flushes changes made to the in-memory copy of a file back to disk. Without " "use of this call there is no guarantee that changes are written back before " "the object is destroyed. If *offset* and *size* are specified, only changes " "to the given range of bytes will be flushed to disk; otherwise, the whole " "extent of the mapping is flushed. *offset* must be a multiple of the :const:" "`PAGESIZE` or :const:`ALLOCATIONGRANULARITY`." msgstr "" #: library/mmap.rst:201 msgid "" "``None`` is returned to indicate success. An exception is raised when the " "call failed." msgstr "" #: library/mmap.rst:204 msgid "" "Previously, a nonzero value was returned on success; zero was returned on " "error under Windows. A zero value was returned on success; an exception was " "raised on error under Unix." msgstr "" #: library/mmap.rst:212 msgid "" "Send advice *option* to the kernel about the memory region beginning at " "*start* and extending *length* bytes. *option* must be one of the :ref:" "`MADV_* constants ` available on the system. If *start* " "and *length* are omitted, the entire mapping is spanned. On some systems " "(including Linux), *start* must be a multiple of the :const:`PAGESIZE`." msgstr "" #: library/mmap.rst:219 msgid "Availability: Systems with the ``madvise()`` system call." msgstr "" #: library/mmap.rst:226 msgid "" "Copy the *count* bytes starting at offset *src* to the destination index " "*dest*. If the mmap was created with :const:`ACCESS_READ`, then calls to " "move will raise a :exc:`TypeError` exception." msgstr "" #: library/mmap.rst:233 msgid "" "Return a :class:`bytes` containing up to *n* bytes starting from the current " "file position. If the argument is omitted, ``None`` or negative, return all " "bytes from the current file position to the end of the mapping. The file " "position is updated to point after the bytes that were returned." msgstr "" #: library/mmap.rst:239 msgid "Argument can be omitted or ``None``." msgstr "" #: library/mmap.rst:244 msgid "" "Returns a byte at the current file position as an integer, and advances the " "file position by 1." msgstr "" #: library/mmap.rst:250 msgid "" "Returns a single line, starting at the current file position and up to the " "next newline. The file position is updated to point after the bytes that " "were returned." msgstr "" #: library/mmap.rst:257 msgid "" "Resizes the map and the underlying file, if any. If the mmap was created " "with :const:`ACCESS_READ` or :const:`ACCESS_COPY`, resizing the map will " "raise a :exc:`TypeError` exception." msgstr "" #: library/mmap.rst:261 msgid "" "**On Windows**: Resizing the map will raise an :exc:`OSError` if there are " "other maps against the same named file. Resizing an anonymous map (ie " "against the pagefile) will silently create a new map with the original data " "copied over up to the length of the new size." msgstr "" #: library/mmap.rst:266 msgid "" "Correctly fails if attempting to resize when another map is held Allows " "resize against an anonymous map on Windows" msgstr "" #: library/mmap.rst:272 msgid "" "Returns the highest index in the object where the subsequence *sub* is " "found, such that *sub* is contained in the range [*start*, *end*]. Optional " "arguments *start* and *end* are interpreted as in slice notation. Returns " "``-1`` on failure." msgstr "" #: library/mmap.rst:283 msgid "" "Set the file's current position. *whence* argument is optional and defaults " "to ``os.SEEK_SET`` or ``0`` (absolute file positioning); other values are " "``os.SEEK_CUR`` or ``1`` (seek relative to the current position) and ``os." "SEEK_END`` or ``2`` (seek relative to the file's end)." msgstr "" #: library/mmap.rst:291 msgid "" "Return the length of the file, which can be larger than the size of the " "memory-mapped area." msgstr "" #: library/mmap.rst:297 msgid "Returns the current position of the file pointer." msgstr "" #: library/mmap.rst:302 msgid "" "Write the bytes in *bytes* into memory at the current position of the file " "pointer and return the number of bytes written (never less than " "``len(bytes)``, since if the write fails, a :exc:`ValueError` will be " "raised). The file position is updated to point after the bytes that were " "written. If the mmap was created with :const:`ACCESS_READ`, then writing to " "it will raise a :exc:`TypeError` exception." msgstr "" #: library/mmap.rst:312 msgid "The number of bytes written is now returned." msgstr "" #: library/mmap.rst:318 msgid "" "Write the integer *byte* into memory at the current position of the file " "pointer; the file position is advanced by ``1``. If the mmap was created " "with :const:`ACCESS_READ`, then writing to it will raise a :exc:`TypeError` " "exception." msgstr "" #: library/mmap.rst:326 msgid "MADV_* Constants" msgstr "" #: library/mmap.rst:353 msgid "" "These options can be passed to :meth:`mmap.madvise`. Not every option will " "be present on every system." msgstr "" #: library/mmap.rst:356 msgid "Availability: Systems with the madvise() system call." msgstr "" #: library/mmap.rst:363 msgid "MAP_* Constants" msgstr "" #: library/mmap.rst:374 msgid "" "These are the various flags that can be passed to :meth:`mmap.mmap`. Note " "that some options might not be present on some systems." msgstr "" #: library/mmap.rst:376 msgid "Added MAP_POPULATE constant." msgstr "" #: library/mmap.rst:379 msgid "Added MAP_STACK constant." msgstr ""