forked from AFPy/python-docs-fr
388 lines
14 KiB
Plaintext
388 lines
14 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: 2023-01-15 22:33+0100\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"
|
|
|
|
#: library/mmap.rst:2
|
|
msgid ":mod:`mmap` --- Memory-mapped file support"
|
|
msgstr ""
|
|
|
|
#: includes/wasm-notavail.rst:None
|
|
msgid ":ref:`Availability <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 <file object>`. 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 <auditing>` ``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 <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 <madvise-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 ""
|