python-docs-fr/library/xdrlib.po

# 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 <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/xdrlib.rst:2
msgid ":mod:`xdrlib` --- Encode and decode XDR data"
msgstr ""

#: library/xdrlib.rst:7
msgid "**Source code:** :source:`Lib/xdrlib.py`"
msgstr "**Code source :** :source:`Lib/xdrlib.py`"

#: library/xdrlib.rst:15
msgid ""
"The :mod:`xdrlib` module supports the External Data Representation Standard "
"as described in :rfc:`1014`, written by Sun Microsystems, Inc. June 1987.  "
"It supports most of the data types described in the RFC."
msgstr ""

#: library/xdrlib.rst:19
msgid ""
"The :mod:`xdrlib` module defines two classes, one for packing variables into "
"XDR representation, and another for unpacking from XDR representation.  "
"There are also two exception classes."
msgstr ""

#: library/xdrlib.rst:26
msgid ""
":class:`Packer` is the class for packing data into XDR representation. The :"
"class:`Packer` class is instantiated with no arguments."
msgstr ""

#: library/xdrlib.rst:32
msgid ""
"``Unpacker`` is the complementary class which unpacks XDR data values from a "
"string buffer.  The input buffer is given as *data*."
msgstr ""

#: library/xdrlib.rst:40
msgid ":rfc:`1014` - XDR: External Data Representation Standard"
msgstr ""

#: library/xdrlib.rst:39
msgid ""
"This RFC defined the encoding of data which was XDR at the time this module "
"was originally written.  It has apparently been obsoleted by :rfc:`1832`."
msgstr ""

#: library/xdrlib.rst:42
msgid ":rfc:`1832` - XDR: External Data Representation Standard"
msgstr ""

#: library/xdrlib.rst:43
msgid "Newer RFC that provides a revised definition of XDR."
msgstr ""

#: library/xdrlib.rst:49
msgid "Packer Objects"
msgstr ""

#: library/xdrlib.rst:51
#, fuzzy
msgid ":class:`Packer` instances have the following methods:"
msgstr "Les instances de :class:`Calendar` ont les méthodes suivantes :"

#: library/xdrlib.rst:56
msgid "Returns the current pack buffer as a string."
msgstr ""

#: library/xdrlib.rst:61
msgid "Resets the pack buffer to the empty string."
msgstr ""

#: library/xdrlib.rst:63
msgid ""
"In general, you can pack any of the most common XDR data types by calling "
"the appropriate ``pack_type()`` method.  Each method takes a single "
"argument, the value to pack.  The following simple data type packing methods "
"are supported: :meth:`pack_uint`, :meth:`pack_int`, :meth:`pack_enum`, :meth:"
"`pack_bool`, :meth:`pack_uhyper`, and :meth:`pack_hyper`."
msgstr ""

#: library/xdrlib.rst:72
msgid "Packs the single-precision floating point number *value*."
msgstr ""

#: library/xdrlib.rst:77
msgid "Packs the double-precision floating point number *value*."
msgstr ""

#: library/xdrlib.rst:79
msgid "The following methods support packing strings, bytes, and opaque data:"
msgstr ""

#: library/xdrlib.rst:84
msgid ""
"Packs a fixed length string, *s*.  *n* is the length of the string but it is "
"*not* packed into the data buffer.  The string is padded with null bytes if "
"necessary to guaranteed 4 byte alignment."
msgstr ""

#: library/xdrlib.rst:91
msgid ""
"Packs a fixed length opaque data stream, similarly to :meth:`pack_fstring`."
msgstr ""

#: library/xdrlib.rst:96
msgid ""
"Packs a variable length string, *s*.  The length of the string is first "
"packed as an unsigned integer, then the string data is packed with :meth:"
"`pack_fstring`."
msgstr ""

#: library/xdrlib.rst:103
msgid ""
"Packs a variable length opaque data string, similarly to :meth:`pack_string`."
msgstr ""

#: library/xdrlib.rst:108
msgid "Packs a variable length byte stream, similarly to :meth:`pack_string`."
msgstr ""

#: library/xdrlib.rst:110
msgid "The following methods support packing arrays and lists:"
msgstr ""

#: library/xdrlib.rst:115
msgid ""
"Packs a *list* of homogeneous items.  This method is useful for lists with "
"an indeterminate size; i.e. the size is not available until the entire list "
"has been walked.  For each item in the list, an unsigned integer ``1`` is "
"packed first, followed by the data value from the list.  *pack_item* is the "
"function that is called to pack the individual item.  At the end of the "
"list, an unsigned integer ``0`` is packed."
msgstr ""

#: library/xdrlib.rst:122
msgid ""
"For example, to pack a list of integers, the code might appear like this::"
msgstr ""

#: library/xdrlib.rst:131
msgid ""
"Packs a fixed length list (*array*) of homogeneous items.  *n* is the length "
"of the list; it is *not* packed into the buffer, but a :exc:`ValueError` "
"exception is raised if ``len(array)`` is not equal to *n*.  As above, "
"*pack_item* is the function used to pack each element."
msgstr ""

#: library/xdrlib.rst:139
msgid ""
"Packs a variable length *list* of homogeneous items.  First, the length of "
"the list is packed as an unsigned integer, then each element is packed as "
"in :meth:`pack_farray` above."
msgstr ""

#: library/xdrlib.rst:147
msgid "Unpacker Objects"
msgstr ""

#: library/xdrlib.rst:149
msgid "The :class:`Unpacker` class offers the following methods:"
msgstr ""

#: library/xdrlib.rst:154
msgid "Resets the string buffer with the given *data*."
msgstr ""

#: library/xdrlib.rst:159
msgid "Returns the current unpack position in the data buffer."
msgstr ""

#: library/xdrlib.rst:164
msgid ""
"Sets the data buffer unpack position to *position*.  You should be careful "
"about using :meth:`get_position` and :meth:`set_position`."
msgstr ""

#: library/xdrlib.rst:170
msgid "Returns the current unpack data buffer as a string."
msgstr ""

#: library/xdrlib.rst:175
msgid ""
"Indicates unpack completion.  Raises an :exc:`Error` exception if all of the "
"data has not been unpacked."
msgstr ""

#: library/xdrlib.rst:178
msgid ""
"In addition, every data type that can be packed with a :class:`Packer`, can "
"be unpacked with an :class:`Unpacker`.  Unpacking methods are of the form "
"``unpack_type()``, and take no arguments.  They return the unpacked object."
msgstr ""

#: library/xdrlib.rst:185
msgid "Unpacks a single-precision floating point number."
msgstr ""

#: library/xdrlib.rst:190
msgid ""
"Unpacks a double-precision floating point number, similarly to :meth:"
"`unpack_float`."
msgstr ""

#: library/xdrlib.rst:193
msgid ""
"In addition, the following methods unpack strings, bytes, and opaque data:"
msgstr ""

#: library/xdrlib.rst:198
msgid ""
"Unpacks and returns a fixed length string.  *n* is the number of characters "
"expected.  Padding with null bytes to guaranteed 4 byte alignment is assumed."
msgstr ""

#: library/xdrlib.rst:204
msgid ""
"Unpacks and returns a fixed length opaque data stream, similarly to :meth:"
"`unpack_fstring`."
msgstr ""

#: library/xdrlib.rst:210
msgid ""
"Unpacks and returns a variable length string.  The length of the string is "
"first unpacked as an unsigned integer, then the string data is unpacked "
"with :meth:`unpack_fstring`."
msgstr ""

#: library/xdrlib.rst:217
msgid ""
"Unpacks and returns a variable length opaque data string, similarly to :meth:"
"`unpack_string`."
msgstr ""

#: library/xdrlib.rst:223
msgid ""
"Unpacks and returns a variable length byte stream, similarly to :meth:"
"`unpack_string`."
msgstr ""

#: library/xdrlib.rst:226
msgid "The following methods support unpacking arrays and lists:"
msgstr ""

#: library/xdrlib.rst:231
msgid ""
"Unpacks and returns a list of homogeneous items.  The list is unpacked one "
"element at a time by first unpacking an unsigned integer flag.  If the flag "
"is ``1``, then the item is unpacked and appended to the list.  A flag of "
"``0`` indicates the end of the list.  *unpack_item* is the function that is "
"called to unpack the items."
msgstr ""

#: library/xdrlib.rst:240
msgid ""
"Unpacks and returns (as a list) a fixed length array of homogeneous items.  "
"*n* is number of list elements to expect in the buffer. As above, "
"*unpack_item* is the function used to unpack each element."
msgstr ""

#: library/xdrlib.rst:247
msgid ""
"Unpacks and returns a variable length *list* of homogeneous items. First, "
"the length of the list is unpacked as an unsigned integer, then each element "
"is unpacked as in :meth:`unpack_farray` above."
msgstr ""

#: library/xdrlib.rst:255
msgid "Exceptions"
msgstr "Exceptions"

#: library/xdrlib.rst:257
msgid "Exceptions in this module are coded as class instances:"
msgstr ""

#: library/xdrlib.rst:262
msgid ""
"The base exception class.  :exc:`Error` has a single public attribute :attr:"
"`msg` containing the description of the error."
msgstr ""

#: library/xdrlib.rst:268
msgid ""
"Class derived from :exc:`Error`.  Contains no additional instance variables."
msgstr ""

#: library/xdrlib.rst:270
msgid "Here is an example of how you would catch one of these exceptions::"
msgstr ""