# 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 \n" "Language-Team: FRENCH \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 ` 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 `, 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 ""