python-docs-fr/library/mmap.po

# SOME DESCRIPTIVE TITLE.
# Copyright (C) 1990-2016, Python Software Foundation
# This file is distributed under the same license as the Python package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Python 2.7\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2016-10-30 10:44+0100\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"

#: ../Doc/library/mmap.rst:3
msgid ":mod:`mmap` --- Memory-mapped file support"
msgstr ""

#: ../Doc/library/mmap.rst:9
msgid ""
"Memory-mapped file objects behave like both strings and like file objects. "
"Unlike normal string objects, however, these are mutable.  You can use mmap "
"objects in most places where strings are expected; for example, you can use "
"the :mod:`re` module to search through a memory-mapped file.  Since they're "
"mutable, you can change a single character by doing ``obj[index] = 'a'``, or "
"change a substring by assigning to a slice: ``obj[i1:i2] = '...'``.  You can "
"also read and write data starting at the current file position, and :meth:"
"`seek` through the file to different positions."
msgstr ""

#: ../Doc/library/mmap.rst:18
msgid ""
"A memory-mapped file is created by the :class:`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 ""

#: ../Doc/library/mmap.rst:27
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 ""

#: ../Doc/library/mmap.rst:32
msgid ""
"For both the Unix and Windows versions of the constructor, *access* may be "
"specified as an optional keyword parameter. *access* accepts one of three "
"values: :const:`ACCESS_READ`, :const:`ACCESS_WRITE`, or :const:`ACCESS_COPY` "
"to specify read-only, write-through or copy-on-write memory respectively. "
"*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 ""

#: ../Doc/library/mmap.rst:44
msgid ""
"To map anonymous memory, -1 should be passed as the fileno along with the "
"length."
msgstr ""

#: ../Doc/library/mmap.rst:48
msgid ""
"mmap.mmap has formerly been a factory function creating mmap objects. Now "
"mmap.mmap is the class itself."
msgstr ""

#: ../Doc/library/mmap.rst:54
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 ""

#: ../Doc/library/mmap.rst:61
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 ""

#: ../Doc/library/mmap.rst:69
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 ALLOCATIONGRANULARITY."
msgstr ""

#: ../Doc/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` is called."
msgstr ""

#: ../Doc/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`."
msgstr ""

#: ../Doc/library/mmap.rst:88
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 ""

#: ../Doc/library/mmap.rst:93
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 ""

#: ../Doc/library/mmap.rst:98
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 PAGESIZE or "
"ALLOCATIONGRANULARITY."
msgstr ""

#: ../Doc/library/mmap.rst:103
msgid ""
"To ensure validity of the created memory mapping the file specified by the "
"descriptor *fileno* is internally automatically synchronized with physical "
"backing store on Mac OS X and OpenVMS."
msgstr ""

#: ../Doc/library/mmap.rst:107
msgid "This example shows a simple way of using :class:`mmap`::"
msgstr ""

#: ../Doc/library/mmap.rst:132
msgid ""
"The next example demonstrates how to create an anonymous map and exchange "
"data between the parent and child processes::"
msgstr ""

#: ../Doc/library/mmap.rst:150
msgid "Memory-mapped file objects support the following methods:"
msgstr ""

#: ../Doc/library/mmap.rst:155
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 ""

#: ../Doc/library/mmap.rst:162
msgid ""
"Returns the lowest index in the object where the substring *string* is "
"found, such that *string* is contained in the range [*start*, *end*]. "
"Optional arguments *start* and *end* are interpreted as in slice notation. "
"Returns ``-1`` on failure."
msgstr ""

#: ../Doc/library/mmap.rst:170
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."
msgstr ""

#: ../Doc/library/mmap.rst:176
msgid ""
"**(Windows version)** A nonzero value returned indicates success; zero "
"indicates failure."
msgstr ""

#: ../Doc/library/mmap.rst:179
msgid ""
"**(Unix version)** A zero value is returned to indicate success. An "
"exception is raised when the call failed."
msgstr ""

#: ../Doc/library/mmap.rst:185
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 ""

#: ../Doc/library/mmap.rst:192
msgid ""
"Return a string containing up to *num* bytes starting from the current file "
"position; the file position is updated to point after the bytes that were "
"returned."
msgstr ""

#: ../Doc/library/mmap.rst:199
msgid ""
"Returns a string of length 1 containing the character at the current file "
"position, and advances the file position by 1."
msgstr ""

#: ../Doc/library/mmap.rst:205
msgid ""
"Returns a single line, starting at the current file position and up to the "
"next newline."
msgstr ""

#: ../Doc/library/mmap.rst:211
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 ""

#: ../Doc/library/mmap.rst:218
msgid ""
"Returns the highest index in the object where the substring *string* is "
"found, such that *string* is contained in the range [*start*, *end*]. "
"Optional arguments *start* and *end* are interpreted as in slice notation. "
"Returns ``-1`` on failure."
msgstr ""

#: ../Doc/library/mmap.rst:226
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 ""

#: ../Doc/library/mmap.rst:234
msgid ""
"Return the length of the file, which can be larger than the size of the "
"memory-mapped area."
msgstr ""

#: ../Doc/library/mmap.rst:240
msgid "Returns the current position of the file pointer."
msgstr ""

#: ../Doc/library/mmap.rst:245
msgid ""
"Write the bytes in *string* into memory at the current position of the file "
"pointer; 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 ""

#: ../Doc/library/mmap.rst:253
msgid ""
"Write the single-character string *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 ""