python-docs-fr/library/csv.po

# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2001-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 3.6\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2017-04-02 22:11+0200\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"
"Language: fr\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"

#: ../Doc/library/csv.rst:2
msgid ":mod:`csv` --- CSV File Reading and Writing"
msgstr ""

#: ../Doc/library/csv.rst:9
msgid "**Source code:** :source:`Lib/csv.py`"
msgstr "**Code source :** :source:`Lib/csv.py`"

#: ../Doc/library/csv.rst:17
msgid ""
"The so-called CSV (Comma Separated Values) format is the most common import "
"and export format for spreadsheets and databases.  CSV format was used for "
"many years prior to attempts to describe the format in a standardized way "
"in :rfc:`4180`.  The lack of a well-defined standard means that subtle "
"differences often exist in the data produced and consumed by different "
"applications.  These differences can make it annoying to process CSV files "
"from multiple sources. Still, while the delimiters and quoting characters "
"vary, the overall format is similar enough that it is possible to write a "
"single module which can efficiently manipulate such data, hiding the details "
"of reading and writing the data from the programmer."
msgstr ""

#: ../Doc/library/csv.rst:28
msgid ""
"The :mod:`csv` module implements classes to read and write tabular data in "
"CSV format.  It allows programmers to say, \"write this data in the format "
"preferred by Excel,\" or \"read data from this file which was generated by "
"Excel,\" without knowing the precise details of the CSV format used by "
"Excel.  Programmers can also describe the CSV formats understood by other "
"applications or define their own special-purpose CSV formats."
msgstr ""

#: ../Doc/library/csv.rst:35
msgid ""
"The :mod:`csv` module's :class:`reader` and :class:`writer` objects read and "
"write sequences.  Programmers can also read and write data in dictionary "
"form using the :class:`DictReader` and :class:`DictWriter` classes."
msgstr ""

#: ../Doc/library/csv.rst:41
msgid ":pep:`305` - CSV File API"
msgstr ""

#: ../Doc/library/csv.rst:42
msgid "The Python Enhancement Proposal which proposed this addition to Python."
msgstr ""

#: ../Doc/library/csv.rst:48
msgid "Module Contents"
msgstr ""

#: ../Doc/library/csv.rst:50
msgid "The :mod:`csv` module defines the following functions:"
msgstr ""

#: ../Doc/library/csv.rst:58
msgid ""
"Return a reader object which will iterate over lines in the given *csvfile*. "
"*csvfile* can be any object which supports the :term:`iterator` protocol and "
"returns a string each time its :meth:`!__next__` method is called --- :term:"
"`file objects <file object>` and list objects are both suitable.   If "
"*csvfile* is a file object, it should be opened with ``newline=''``. [1]_  "
"An optional *dialect* parameter can be given which is used to define a set "
"of parameters specific to a particular CSV dialect.  It may be an instance "
"of a subclass of the :class:`Dialect` class or one of the strings returned "
"by the :func:`list_dialects` function.  The other optional *fmtparams* "
"keyword arguments can be given to override individual formatting parameters "
"in the current dialect.  For full details about the dialect and formatting "
"parameters, see section :ref:`csv-fmt-params`."
msgstr ""

#: ../Doc/library/csv.rst:71
msgid ""
"Each row read from the csv file is returned as a list of strings.  No "
"automatic data type conversion is performed unless the ``QUOTE_NONNUMERIC`` "
"format option is specified (in which case unquoted fields are transformed "
"into floats)."
msgstr ""

#: ../Doc/library/csv.rst:75 ../Doc/library/csv.rst:105
#: ../Doc/library/csv.rst:172 ../Doc/library/csv.rst:210
msgid "A short usage example::"
msgstr ""

#: ../Doc/library/csv.rst:88
msgid ""
"Return a writer object responsible for converting the user's data into "
"delimited strings on the given file-like object.  *csvfile* can be any "
"object with a :func:`write` method.  If *csvfile* is a file object, it "
"should be opened with ``newline=''`` [1]_.  An optional *dialect* parameter "
"can be given which is used to define a set of parameters specific to a "
"particular CSV dialect.  It may be an instance of a subclass of the :class:"
"`Dialect` class or one of the strings returned by the :func:`list_dialects` "
"function.  The other optional *fmtparams* keyword arguments can be given to "
"override individual formatting parameters in the current dialect.  For full "
"details about the dialect and formatting parameters, see section :ref:`csv-"
"fmt-params`. To make it as easy as possible to interface with modules which "
"implement the DB API, the value :const:`None` is written as the empty "
"string.  While this isn't a reversible transformation, it makes it easier to "
"dump SQL NULL data values to CSV files without preprocessing the data "
"returned from a ``cursor.fetch*`` call. All other non-string data are "
"stringified with :func:`str` before being written."
msgstr ""

#: ../Doc/library/csv.rst:117
msgid ""
"Associate *dialect* with *name*.  *name* must be a string. The dialect can "
"be specified either by passing a sub-class of :class:`Dialect`, or by "
"*fmtparams* keyword arguments, or both, with keyword arguments overriding "
"parameters of the dialect. For full details about the dialect and formatting "
"parameters, see section :ref:`csv-fmt-params`."
msgstr ""

#: ../Doc/library/csv.rst:126
msgid ""
"Delete the dialect associated with *name* from the dialect registry.  An :"
"exc:`Error` is raised if *name* is not a registered dialect name."
msgstr ""

#: ../Doc/library/csv.rst:132
msgid ""
"Return the dialect associated with *name*.  An :exc:`Error` is raised if "
"*name* is not a registered dialect name.  This function returns an "
"immutable :class:`Dialect`."
msgstr ""

#: ../Doc/library/csv.rst:138
msgid "Return the names of all registered dialects."
msgstr ""

#: ../Doc/library/csv.rst:143
msgid ""
"Returns the current maximum field size allowed by the parser. If *new_limit* "
"is given, this becomes the new limit."
msgstr ""

#: ../Doc/library/csv.rst:147
msgid "The :mod:`csv` module defines the following classes:"
msgstr ""

#: ../Doc/library/csv.rst:152
msgid ""
"Create an object that operates like a regular reader but maps the "
"information in each row to an :mod:`OrderedDict <collections.OrderedDict>` "
"whose keys are given by the optional *fieldnames* parameter."
msgstr ""

#: ../Doc/library/csv.rst:156
msgid ""
"The *fieldnames* parameter is a :term:`sequence`.  If *fieldnames* is "
"omitted, the values in the first row of file *f* will be used as the "
"fieldnames.  Regardless of how the fieldnames are determined, the ordered "
"dictionary preserves their original ordering."
msgstr ""

#: ../Doc/library/csv.rst:161
msgid ""
"If a row has more fields than fieldnames, the remaining data is put in a "
"list and stored with the fieldname specified by *restkey* (which defaults to "
"``None``).  If a non-blank row has fewer fields than fieldnames, the missing "
"values are filled-in with ``None``."
msgstr ""

#: ../Doc/library/csv.rst:166
msgid ""
"All other optional or keyword arguments are passed to the underlying :class:"
"`reader` instance."
msgstr ""

#: ../Doc/library/csv.rst:169
msgid "Returned rows are now of type :class:`OrderedDict`."
msgstr ""

#: ../Doc/library/csv.rst:190
msgid ""
"Create an object which operates like a regular writer but maps dictionaries "
"onto output rows.  The *fieldnames* parameter is a :mod:`sequence "
"<collections.abc>` of keys that identify the order in which values in the "
"dictionary passed to the :meth:`writerow` method are written to file *f*.  "
"The optional *restval* parameter specifies the value to be written if the "
"dictionary is missing a key in *fieldnames*.  If the dictionary passed to "
"the :meth:`writerow` method contains a key not found in *fieldnames*, the "
"optional *extrasaction* parameter indicates what action to take. If it is "
"set to ``'raise'``, the default value, a :exc:`ValueError` is raised. If it "
"is set to ``'ignore'``, extra values in the dictionary are ignored. Any "
"other optional or keyword arguments are passed to the underlying :class:"
"`writer` instance."
msgstr ""

#: ../Doc/library/csv.rst:205
msgid ""
"Note that unlike the :class:`DictReader` class, the *fieldnames* parameter "
"of the :class:`DictWriter` is not optional.  Since Python's :class:`dict` "
"objects are not ordered, there is not enough information available to deduce "
"the order in which the row should be written to file *f*."
msgstr ""

#: ../Doc/library/csv.rst:226
msgid ""
"The :class:`Dialect` class is a container class relied on primarily for its "
"attributes, which are used to define the parameters for a specific :class:"
"`reader` or :class:`writer` instance."
msgstr ""

#: ../Doc/library/csv.rst:233
msgid ""
"The :class:`excel` class defines the usual properties of an Excel-generated "
"CSV file.  It is registered with the dialect name ``'excel'``."
msgstr ""

#: ../Doc/library/csv.rst:239
msgid ""
"The :class:`excel_tab` class defines the usual properties of an Excel-"
"generated TAB-delimited file.  It is registered with the dialect name "
"``'excel-tab'``."
msgstr ""

#: ../Doc/library/csv.rst:245
msgid ""
"The :class:`unix_dialect` class defines the usual properties of a CSV file "
"generated on UNIX systems, i.e. using ``'\\n'`` as line terminator and "
"quoting all fields.  It is registered with the dialect name ``'unix'``."
msgstr ""

#: ../Doc/library/csv.rst:254
msgid "The :class:`Sniffer` class is used to deduce the format of a CSV file."
msgstr ""

#: ../Doc/library/csv.rst:256
msgid "The :class:`Sniffer` class provides two methods:"
msgstr ""

#: ../Doc/library/csv.rst:260
msgid ""
"Analyze the given *sample* and return a :class:`Dialect` subclass reflecting "
"the parameters found.  If the optional *delimiters* parameter is given, it "
"is interpreted as a string containing possible valid delimiter characters."
msgstr ""

#: ../Doc/library/csv.rst:268
msgid ""
"Analyze the sample text (presumed to be in CSV format) and return :const:"
"`True` if the first row appears to be a series of column headers."
msgstr ""

#: ../Doc/library/csv.rst:271
msgid "An example for :class:`Sniffer` use::"
msgstr ""

#: ../Doc/library/csv.rst:280
msgid "The :mod:`csv` module defines the following constants:"
msgstr ""

#: ../Doc/library/csv.rst:284
msgid "Instructs :class:`writer` objects to quote all fields."
msgstr ""

#: ../Doc/library/csv.rst:289
msgid ""
"Instructs :class:`writer` objects to only quote those fields which contain "
"special characters such as *delimiter*, *quotechar* or any of the characters "
"in *lineterminator*."
msgstr ""

#: ../Doc/library/csv.rst:296
msgid "Instructs :class:`writer` objects to quote all non-numeric fields."
msgstr ""

#: ../Doc/library/csv.rst:298
msgid "Instructs the reader to convert all non-quoted fields to type *float*."
msgstr ""

#: ../Doc/library/csv.rst:303
msgid ""
"Instructs :class:`writer` objects to never quote fields.  When the current "
"*delimiter* occurs in output data it is preceded by the current *escapechar* "
"character.  If *escapechar* is not set, the writer will raise :exc:`Error` "
"if any characters that require escaping are encountered."
msgstr ""

#: ../Doc/library/csv.rst:308
msgid ""
"Instructs :class:`reader` to perform no special processing of quote "
"characters."
msgstr ""

#: ../Doc/library/csv.rst:310
msgid "The :mod:`csv` module defines the following exception:"
msgstr ""

#: ../Doc/library/csv.rst:315
msgid "Raised by any of the functions when an error is detected."
msgstr ""

#: ../Doc/library/csv.rst:320
msgid "Dialects and Formatting Parameters"
msgstr ""

#: ../Doc/library/csv.rst:322
msgid ""
"To make it easier to specify the format of input and output records, "
"specific formatting parameters are grouped together into dialects.  A "
"dialect is a subclass of the :class:`Dialect` class having a set of specific "
"methods and a single :meth:`validate` method.  When creating :class:`reader` "
"or :class:`writer` objects, the programmer can specify a string or a "
"subclass of the :class:`Dialect` class as the dialect parameter.  In "
"addition to, or instead of, the *dialect* parameter, the programmer can also "
"specify individual formatting parameters, which have the same names as the "
"attributes defined below for the :class:`Dialect` class."
msgstr ""

#: ../Doc/library/csv.rst:332
msgid "Dialects support the following attributes:"
msgstr ""

#: ../Doc/library/csv.rst:337
msgid ""
"A one-character string used to separate fields.  It defaults to ``','``."
msgstr ""

#: ../Doc/library/csv.rst:342
msgid ""
"Controls how instances of *quotechar* appearing inside a field should "
"themselves be quoted.  When :const:`True`, the character is doubled. When :"
"const:`False`, the *escapechar* is used as a prefix to the *quotechar*.  It "
"defaults to :const:`True`."
msgstr ""

#: ../Doc/library/csv.rst:347
msgid ""
"On output, if *doublequote* is :const:`False` and no *escapechar* is set, :"
"exc:`Error` is raised if a *quotechar* is found in a field."
msgstr ""

#: ../Doc/library/csv.rst:353
msgid ""
"A one-character string used by the writer to escape the *delimiter* if "
"*quoting* is set to :const:`QUOTE_NONE` and the *quotechar* if *doublequote* "
"is :const:`False`. On reading, the *escapechar* removes any special meaning "
"from the following character. It defaults to :const:`None`, which disables "
"escaping."
msgstr ""

#: ../Doc/library/csv.rst:361
msgid ""
"The string used to terminate lines produced by the :class:`writer`. It "
"defaults to ``'\\r\\n'``."
msgstr ""

#: ../Doc/library/csv.rst:366
msgid ""
"The :class:`reader` is hard-coded to recognise either ``'\\r'`` or ``'\\n'`` "
"as end-of-line, and ignores *lineterminator*. This behavior may change in "
"the future."
msgstr ""

#: ../Doc/library/csv.rst:373
msgid ""
"A one-character string used to quote fields containing special characters, "
"such as the *delimiter* or *quotechar*, or which contain new-line "
"characters.  It defaults to ``'\"'``."
msgstr ""

#: ../Doc/library/csv.rst:380
msgid ""
"Controls when quotes should be generated by the writer and recognised by the "
"reader.  It can take on any of the :const:`QUOTE_\\*` constants (see "
"section :ref:`csv-contents`) and defaults to :const:`QUOTE_MINIMAL`."
msgstr ""

#: ../Doc/library/csv.rst:387
msgid ""
"When :const:`True`, whitespace immediately following the *delimiter* is "
"ignored. The default is :const:`False`."
msgstr ""

#: ../Doc/library/csv.rst:393
msgid ""
"When ``True``, raise exception :exc:`Error` on bad CSV input. The default is "
"``False``."
msgstr ""

#: ../Doc/library/csv.rst:397
msgid "Reader Objects"
msgstr ""

#: ../Doc/library/csv.rst:399
msgid ""
"Reader objects (:class:`DictReader` instances and objects returned by the :"
"func:`reader` function) have the following public methods:"
msgstr ""

#: ../Doc/library/csv.rst:404
msgid ""
"Return the next row of the reader's iterable object as a list, parsed "
"according to the current dialect.  Usually you should call this as "
"``next(reader)``."
msgstr ""

#: ../Doc/library/csv.rst:408
msgid "Reader objects have the following public attributes:"
msgstr ""

#: ../Doc/library/csv.rst:412
msgid "A read-only description of the dialect in use by the parser."
msgstr ""

#: ../Doc/library/csv.rst:417
msgid ""
"The number of lines read from the source iterator. This is not the same as "
"the number of records returned, as records can span multiple lines."
msgstr ""

#: ../Doc/library/csv.rst:421
msgid "DictReader objects have the following public attribute:"
msgstr ""

#: ../Doc/library/csv.rst:425
msgid ""
"If not passed as a parameter when creating the object, this attribute is "
"initialized upon first access or when the first record is read from the file."
msgstr ""

#: ../Doc/library/csv.rst:432
msgid "Writer Objects"
msgstr ""

#: ../Doc/library/csv.rst:434
msgid ""
":class:`Writer` objects (:class:`DictWriter` instances and objects returned "
"by the :func:`writer` function) have the following public methods.  A *row* "
"must be an iterable of strings or numbers for :class:`Writer` objects and a "
"dictionary mapping fieldnames to strings or numbers (by passing them "
"through :func:`str` first) for :class:`DictWriter` objects.  Note that "
"complex numbers are written out surrounded by parens. This may cause some "
"problems for other programs which read CSV files (assuming they support "
"complex numbers at all)."
msgstr ""

#: ../Doc/library/csv.rst:445
msgid ""
"Write the *row* parameter to the writer's file object, formatted according "
"to the current dialect."
msgstr ""

#: ../Doc/library/csv.rst:448
msgid "Added support of arbitrary iterables."
msgstr ""

#: ../Doc/library/csv.rst:453
msgid ""
"Write all the *rows* parameters (a list of *row* objects as described above) "
"to the writer's file object, formatted according to the current dialect."
msgstr ""

#: ../Doc/library/csv.rst:456
msgid "Writer objects have the following public attribute:"
msgstr ""

#: ../Doc/library/csv.rst:461
msgid "A read-only description of the dialect in use by the writer."
msgstr ""

#: ../Doc/library/csv.rst:464
msgid "DictWriter objects have the following public method:"
msgstr ""

#: ../Doc/library/csv.rst:469
msgid "Write a row with the field names (as specified in the constructor)."
msgstr ""

#: ../Doc/library/csv.rst:477
msgid "Examples"
msgstr "Exemples"

#: ../Doc/library/csv.rst:479
msgid "The simplest example of reading a CSV file::"
msgstr ""

#: ../Doc/library/csv.rst:487
msgid "Reading a file with an alternate format::"
msgstr ""

#: ../Doc/library/csv.rst:495
msgid "The corresponding simplest possible writing example is::"
msgstr ""

#: ../Doc/library/csv.rst:502
msgid ""
"Since :func:`open` is used to open a CSV file for reading, the file will by "
"default be decoded into unicode using the system default encoding (see :func:"
"`locale.getpreferredencoding`).  To decode a file using a different "
"encoding, use the ``encoding`` argument of open::"
msgstr ""

#: ../Doc/library/csv.rst:513
msgid ""
"The same applies to writing in something other than the system default "
"encoding: specify the encoding argument when opening the output file."
msgstr ""

#: ../Doc/library/csv.rst:516
msgid "Registering a new dialect::"
msgstr ""

#: ../Doc/library/csv.rst:523
msgid ""
"A slightly more advanced use of the reader --- catching and reporting "
"errors::"
msgstr ""

#: ../Doc/library/csv.rst:535
msgid ""
"And while the module doesn't directly support parsing strings, it can easily "
"be done::"
msgstr ""

#: ../Doc/library/csv.rst:544
msgid "Footnotes"
msgstr "Notes"

#: ../Doc/library/csv.rst:545
msgid ""
"If ``newline=''`` is not specified, newlines embedded inside quoted fields "
"will not be interpreted correctly, and on platforms that use ``\\r\\n`` "
"linendings on write an extra ``\\r`` will be added.  It should always be "
"safe to specify ``newline=''``, since the csv module does its own (:term:"
"`universal <universal newlines>`) newline handling."
msgstr ""