forked from AFPy/python-docs-fr
426 lines
14 KiB
Plaintext
426 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: 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/xml.sax.reader.rst:2
|
|
msgid ":mod:`xml.sax.xmlreader` --- Interface for XML parsers"
|
|
msgstr ""
|
|
|
|
#: library/xml.sax.reader.rst:10
|
|
msgid "**Source code:** :source:`Lib/xml/sax/xmlreader.py`"
|
|
msgstr ""
|
|
|
|
#: library/xml.sax.reader.rst:14
|
|
msgid ""
|
|
"SAX parsers implement the :class:`XMLReader` interface. They are implemented "
|
|
"in a Python module, which must provide a function :func:`create_parser`. "
|
|
"This function is invoked by :func:`xml.sax.make_parser` with no arguments "
|
|
"to create a new parser object."
|
|
msgstr ""
|
|
|
|
#: library/xml.sax.reader.rst:22
|
|
msgid "Base class which can be inherited by SAX parsers."
|
|
msgstr ""
|
|
|
|
#: library/xml.sax.reader.rst:27
|
|
msgid ""
|
|
"In some cases, it is desirable not to parse an input source at once, but to "
|
|
"feed chunks of the document as they get available. Note that the reader will "
|
|
"normally not read the entire file, but read it in chunks as well; still :"
|
|
"meth:`parse` won't return until the entire document is processed. So these "
|
|
"interfaces should be used if the blocking behaviour of :meth:`parse` is not "
|
|
"desirable."
|
|
msgstr ""
|
|
|
|
#: library/xml.sax.reader.rst:33
|
|
msgid ""
|
|
"When the parser is instantiated it is ready to begin accepting data from the "
|
|
"feed method immediately. After parsing has been finished with a call to "
|
|
"close the reset method must be called to make the parser ready to accept new "
|
|
"data, either from feed or using the parse method."
|
|
msgstr ""
|
|
|
|
#: library/xml.sax.reader.rst:38
|
|
msgid ""
|
|
"Note that these methods must *not* be called during parsing, that is, after "
|
|
"parse has been called and before it returns."
|
|
msgstr ""
|
|
|
|
#: library/xml.sax.reader.rst:41
|
|
msgid ""
|
|
"By default, the class also implements the parse method of the XMLReader "
|
|
"interface using the feed, close and reset methods of the IncrementalParser "
|
|
"interface as a convenience to SAX 2.0 driver writers."
|
|
msgstr ""
|
|
|
|
#: library/xml.sax.reader.rst:48
|
|
msgid ""
|
|
"Interface for associating a SAX event with a document location. A locator "
|
|
"object will return valid results only during calls to DocumentHandler "
|
|
"methods; at any other time, the results are unpredictable. If information is "
|
|
"not available, methods may return ``None``."
|
|
msgstr ""
|
|
|
|
#: library/xml.sax.reader.rst:56
|
|
msgid ""
|
|
"Encapsulation of the information needed by the :class:`XMLReader` to read "
|
|
"entities."
|
|
msgstr ""
|
|
|
|
#: library/xml.sax.reader.rst:59
|
|
msgid ""
|
|
"This class may include information about the public identifier, system "
|
|
"identifier, byte stream (possibly with character encoding information) and/"
|
|
"or the character stream of an entity."
|
|
msgstr ""
|
|
|
|
#: library/xml.sax.reader.rst:63
|
|
msgid ""
|
|
"Applications will create objects of this class for use in the :meth:"
|
|
"`XMLReader.parse` method and for returning from EntityResolver.resolveEntity."
|
|
msgstr ""
|
|
|
|
#: library/xml.sax.reader.rst:67
|
|
msgid ""
|
|
"An :class:`InputSource` belongs to the application, the :class:`XMLReader` "
|
|
"is not allowed to modify :class:`InputSource` objects passed to it from the "
|
|
"application, although it may make copies and modify those."
|
|
msgstr ""
|
|
|
|
#: library/xml.sax.reader.rst:74
|
|
msgid ""
|
|
"This is an implementation of the :class:`Attributes` interface (see section :"
|
|
"ref:`attributes-objects`). This is a dictionary-like object which "
|
|
"represents the element attributes in a :meth:`startElement` call. In "
|
|
"addition to the most useful dictionary operations, it supports a number of "
|
|
"other methods as described by the interface. Objects of this class should be "
|
|
"instantiated by readers; *attrs* must be a dictionary-like object containing "
|
|
"a mapping from attribute names to attribute values."
|
|
msgstr ""
|
|
|
|
#: library/xml.sax.reader.rst:85
|
|
msgid ""
|
|
"Namespace-aware variant of :class:`AttributesImpl`, which will be passed to :"
|
|
"meth:`startElementNS`. It is derived from :class:`AttributesImpl`, but "
|
|
"understands attribute names as two-tuples of *namespaceURI* and *localname*. "
|
|
"In addition, it provides a number of methods expecting qualified names as "
|
|
"they appear in the original document. This class implements the :class:"
|
|
"`AttributesNS` interface (see section :ref:`attributes-ns-objects`)."
|
|
msgstr ""
|
|
|
|
#: library/xml.sax.reader.rst:96
|
|
msgid "XMLReader Objects"
|
|
msgstr ""
|
|
|
|
#: library/xml.sax.reader.rst:98
|
|
msgid "The :class:`XMLReader` interface supports the following methods:"
|
|
msgstr ""
|
|
|
|
#: library/xml.sax.reader.rst:103
|
|
msgid ""
|
|
"Process an input source, producing SAX events. The *source* object can be a "
|
|
"system identifier (a string identifying the input source -- typically a file "
|
|
"name or a URL), a :class:`pathlib.Path` or :term:`path-like <path-like "
|
|
"object>` object, or an :class:`InputSource` object. When :meth:`parse` "
|
|
"returns, the input is completely processed, and the parser object can be "
|
|
"discarded or reset."
|
|
msgstr ""
|
|
|
|
#: library/xml.sax.reader.rst:110
|
|
msgid "Added support of character streams."
|
|
msgstr ""
|
|
|
|
#: library/xml.sax.reader.rst:113
|
|
msgid "Added support of path-like objects."
|
|
msgstr ""
|
|
|
|
#: library/xml.sax.reader.rst:119
|
|
msgid "Return the current :class:`~xml.sax.handler.ContentHandler`."
|
|
msgstr ""
|
|
|
|
#: library/xml.sax.reader.rst:124
|
|
msgid ""
|
|
"Set the current :class:`~xml.sax.handler.ContentHandler`. If no :class:"
|
|
"`~xml.sax.handler.ContentHandler` is set, content events will be discarded."
|
|
msgstr ""
|
|
|
|
#: library/xml.sax.reader.rst:131
|
|
msgid "Return the current :class:`~xml.sax.handler.DTDHandler`."
|
|
msgstr ""
|
|
|
|
#: library/xml.sax.reader.rst:136
|
|
msgid ""
|
|
"Set the current :class:`~xml.sax.handler.DTDHandler`. If no :class:`~xml."
|
|
"sax.handler.DTDHandler` is set, DTD events will be discarded."
|
|
msgstr ""
|
|
|
|
#: library/xml.sax.reader.rst:143
|
|
msgid "Return the current :class:`~xml.sax.handler.EntityResolver`."
|
|
msgstr ""
|
|
|
|
#: library/xml.sax.reader.rst:148
|
|
msgid ""
|
|
"Set the current :class:`~xml.sax.handler.EntityResolver`. If no :class:"
|
|
"`~xml.sax.handler.EntityResolver` is set, attempts to resolve an external "
|
|
"entity will result in opening the system identifier for the entity, and fail "
|
|
"if it is not available."
|
|
msgstr ""
|
|
|
|
#: library/xml.sax.reader.rst:156
|
|
msgid "Return the current :class:`~xml.sax.handler.ErrorHandler`."
|
|
msgstr ""
|
|
|
|
#: library/xml.sax.reader.rst:161
|
|
msgid ""
|
|
"Set the current error handler. If no :class:`~xml.sax.handler.ErrorHandler` "
|
|
"is set, errors will be raised as exceptions, and warnings will be printed."
|
|
msgstr ""
|
|
|
|
#: library/xml.sax.reader.rst:167
|
|
msgid "Allow an application to set the locale for errors and warnings."
|
|
msgstr ""
|
|
|
|
#: library/xml.sax.reader.rst:169
|
|
msgid ""
|
|
"SAX parsers are not required to provide localization for errors and "
|
|
"warnings; if they cannot support the requested locale, however, they must "
|
|
"raise a SAX exception. Applications may request a locale change in the "
|
|
"middle of a parse."
|
|
msgstr ""
|
|
|
|
#: library/xml.sax.reader.rst:176
|
|
msgid ""
|
|
"Return the current setting for feature *featurename*. If the feature is not "
|
|
"recognized, :exc:`SAXNotRecognizedException` is raised. The well-known "
|
|
"featurenames are listed in the module :mod:`xml.sax.handler`."
|
|
msgstr ""
|
|
|
|
#: library/xml.sax.reader.rst:183
|
|
msgid ""
|
|
"Set the *featurename* to *value*. If the feature is not recognized, :exc:"
|
|
"`SAXNotRecognizedException` is raised. If the feature or its setting is not "
|
|
"supported by the parser, *SAXNotSupportedException* is raised."
|
|
msgstr ""
|
|
|
|
#: library/xml.sax.reader.rst:190
|
|
msgid ""
|
|
"Return the current setting for property *propertyname*. If the property is "
|
|
"not recognized, a :exc:`SAXNotRecognizedException` is raised. The well-known "
|
|
"propertynames are listed in the module :mod:`xml.sax.handler`."
|
|
msgstr ""
|
|
|
|
#: library/xml.sax.reader.rst:197
|
|
msgid ""
|
|
"Set the *propertyname* to *value*. If the property is not recognized, :exc:"
|
|
"`SAXNotRecognizedException` is raised. If the property or its setting is not "
|
|
"supported by the parser, *SAXNotSupportedException* is raised."
|
|
msgstr ""
|
|
|
|
#: library/xml.sax.reader.rst:205
|
|
msgid "IncrementalParser Objects"
|
|
msgstr ""
|
|
|
|
#: library/xml.sax.reader.rst:207
|
|
msgid ""
|
|
"Instances of :class:`IncrementalParser` offer the following additional "
|
|
"methods:"
|
|
msgstr ""
|
|
|
|
#: library/xml.sax.reader.rst:212
|
|
msgid "Process a chunk of *data*."
|
|
msgstr ""
|
|
|
|
#: library/xml.sax.reader.rst:217
|
|
msgid ""
|
|
"Assume the end of the document. That will check well-formedness conditions "
|
|
"that can be checked only at the end, invoke handlers, and may clean up "
|
|
"resources allocated during parsing."
|
|
msgstr ""
|
|
|
|
#: library/xml.sax.reader.rst:224
|
|
msgid ""
|
|
"This method is called after close has been called to reset the parser so "
|
|
"that it is ready to parse new documents. The results of calling parse or "
|
|
"feed after close without calling reset are undefined."
|
|
msgstr ""
|
|
|
|
#: library/xml.sax.reader.rst:232
|
|
msgid "Locator Objects"
|
|
msgstr ""
|
|
|
|
#: library/xml.sax.reader.rst:234
|
|
msgid "Instances of :class:`Locator` provide these methods:"
|
|
msgstr ""
|
|
|
|
#: library/xml.sax.reader.rst:239
|
|
msgid "Return the column number where the current event begins."
|
|
msgstr ""
|
|
|
|
#: library/xml.sax.reader.rst:244
|
|
msgid "Return the line number where the current event begins."
|
|
msgstr ""
|
|
|
|
#: library/xml.sax.reader.rst:249
|
|
msgid "Return the public identifier for the current event."
|
|
msgstr ""
|
|
|
|
#: library/xml.sax.reader.rst:254
|
|
msgid "Return the system identifier for the current event."
|
|
msgstr ""
|
|
|
|
#: library/xml.sax.reader.rst:260
|
|
msgid "InputSource Objects"
|
|
msgstr ""
|
|
|
|
#: library/xml.sax.reader.rst:265
|
|
msgid "Sets the public identifier of this :class:`InputSource`."
|
|
msgstr ""
|
|
|
|
#: library/xml.sax.reader.rst:270
|
|
msgid "Returns the public identifier of this :class:`InputSource`."
|
|
msgstr ""
|
|
|
|
#: library/xml.sax.reader.rst:275
|
|
msgid "Sets the system identifier of this :class:`InputSource`."
|
|
msgstr ""
|
|
|
|
#: library/xml.sax.reader.rst:280
|
|
msgid "Returns the system identifier of this :class:`InputSource`."
|
|
msgstr ""
|
|
|
|
#: library/xml.sax.reader.rst:285
|
|
msgid "Sets the character encoding of this :class:`InputSource`."
|
|
msgstr ""
|
|
|
|
#: library/xml.sax.reader.rst:287
|
|
msgid ""
|
|
"The encoding must be a string acceptable for an XML encoding declaration "
|
|
"(see section 4.3.3 of the XML recommendation)."
|
|
msgstr ""
|
|
|
|
#: library/xml.sax.reader.rst:290
|
|
msgid ""
|
|
"The encoding attribute of the :class:`InputSource` is ignored if the :class:"
|
|
"`InputSource` also contains a character stream."
|
|
msgstr ""
|
|
|
|
#: library/xml.sax.reader.rst:296
|
|
msgid "Get the character encoding of this InputSource."
|
|
msgstr ""
|
|
|
|
#: library/xml.sax.reader.rst:301
|
|
msgid "Set the byte stream (a :term:`binary file`) for this input source."
|
|
msgstr ""
|
|
|
|
#: library/xml.sax.reader.rst:303
|
|
msgid ""
|
|
"The SAX parser will ignore this if there is also a character stream "
|
|
"specified, but it will use a byte stream in preference to opening a URI "
|
|
"connection itself."
|
|
msgstr ""
|
|
|
|
#: library/xml.sax.reader.rst:306
|
|
msgid ""
|
|
"If the application knows the character encoding of the byte stream, it "
|
|
"should set it with the setEncoding method."
|
|
msgstr ""
|
|
|
|
#: library/xml.sax.reader.rst:312
|
|
msgid "Get the byte stream for this input source."
|
|
msgstr ""
|
|
|
|
#: library/xml.sax.reader.rst:314
|
|
msgid ""
|
|
"The getEncoding method will return the character encoding for this byte "
|
|
"stream, or ``None`` if unknown."
|
|
msgstr ""
|
|
|
|
#: library/xml.sax.reader.rst:320
|
|
msgid "Set the character stream (a :term:`text file`) for this input source."
|
|
msgstr ""
|
|
|
|
#: library/xml.sax.reader.rst:322
|
|
msgid ""
|
|
"If there is a character stream specified, the SAX parser will ignore any "
|
|
"byte stream and will not attempt to open a URI connection to the system "
|
|
"identifier."
|
|
msgstr ""
|
|
|
|
#: library/xml.sax.reader.rst:328
|
|
msgid "Get the character stream for this input source."
|
|
msgstr ""
|
|
|
|
#: library/xml.sax.reader.rst:334
|
|
msgid "The :class:`Attributes` Interface"
|
|
msgstr ""
|
|
|
|
#: library/xml.sax.reader.rst:336
|
|
msgid ""
|
|
":class:`Attributes` objects implement a portion of the :term:`mapping "
|
|
"protocol <mapping>`, including the methods :meth:`~collections.abc.Mapping."
|
|
"copy`, :meth:`~collections.abc.Mapping.get`, :meth:`~object.__contains__`, :"
|
|
"meth:`~collections.abc.Mapping.items`, :meth:`~collections.abc.Mapping."
|
|
"keys`, and :meth:`~collections.abc.Mapping.values`. The following methods "
|
|
"are also provided:"
|
|
msgstr ""
|
|
|
|
#: library/xml.sax.reader.rst:346
|
|
msgid "Return the number of attributes."
|
|
msgstr ""
|
|
|
|
#: library/xml.sax.reader.rst:351
|
|
msgid "Return the names of the attributes."
|
|
msgstr ""
|
|
|
|
#: library/xml.sax.reader.rst:356
|
|
msgid ""
|
|
"Returns the type of the attribute *name*, which is normally ``'CDATA'``."
|
|
msgstr ""
|
|
|
|
#: library/xml.sax.reader.rst:361
|
|
msgid "Return the value of attribute *name*."
|
|
msgstr ""
|
|
|
|
#: library/xml.sax.reader.rst:370
|
|
msgid "The :class:`AttributesNS` Interface"
|
|
msgstr ""
|
|
|
|
#: library/xml.sax.reader.rst:372
|
|
msgid ""
|
|
"This interface is a subtype of the :class:`Attributes` interface (see "
|
|
"section :ref:`attributes-objects`). All methods supported by that interface "
|
|
"are also available on :class:`AttributesNS` objects."
|
|
msgstr ""
|
|
|
|
#: library/xml.sax.reader.rst:376
|
|
msgid "The following methods are also available:"
|
|
msgstr ""
|
|
|
|
#: library/xml.sax.reader.rst:381
|
|
msgid "Return the value for a qualified name."
|
|
msgstr ""
|
|
|
|
#: library/xml.sax.reader.rst:386
|
|
msgid "Return the ``(namespace, localname)`` pair for a qualified *name*."
|
|
msgstr ""
|
|
|
|
#: library/xml.sax.reader.rst:391
|
|
msgid "Return the qualified name for a ``(namespace, localname)`` pair."
|
|
msgstr ""
|
|
|
|
#: library/xml.sax.reader.rst:396
|
|
msgid "Return the qualified names of all attributes."
|
|
msgstr ""
|