python-docs-fr/library/xml.etree.elementtree.po

# Copyright (C) 2001-2018, Python Software Foundation
# For licence information, see README file.
#
msgid ""
msgstr ""
"Project-Id-Version: Python 3.6\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-11-15 18:54+0100\n"
"PO-Revision-Date: 2018-07-04 11:02+0200\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"

#: ../Doc/library/xml.etree.elementtree.rst:2
msgid ":mod:`xml.etree.ElementTree` --- The ElementTree XML API"
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:9
msgid "**Source code:** :source:`Lib/xml/etree/ElementTree.py`"
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:13
msgid ""
"The :mod:`xml.etree.ElementTree` module implements a simple and efficient "
"API for parsing and creating XML data."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:16
msgid ""
"This module will use a fast implementation whenever available. The :mod:`xml."
"etree.cElementTree` module is deprecated."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:23
msgid ""
"The :mod:`xml.etree.ElementTree` module is not secure against maliciously "
"constructed data.  If you need to parse untrusted or unauthenticated data "
"see :ref:`xml-vulnerabilities`."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:28
msgid "Tutorial"
msgstr "Tutoriel"

#: ../Doc/library/xml.etree.elementtree.rst:30
msgid ""
"This is a short tutorial for using :mod:`xml.etree.ElementTree` (``ET`` in "
"short).  The goal is to demonstrate some of the building blocks and basic "
"concepts of the module."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:35
msgid "XML tree and elements"
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:37
msgid ""
"XML is an inherently hierarchical data format, and the most natural way to "
"represent it is with a tree.  ``ET`` has two classes for this purpose - :"
"class:`ElementTree` represents the whole XML document as a tree, and :class:"
"`Element` represents a single node in this tree.  Interactions with the "
"whole document (reading and writing to/from files) are usually done on the :"
"class:`ElementTree` level.  Interactions with a single XML element and its "
"sub-elements are done on the :class:`Element` level."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:48
msgid "Parsing XML"
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:50
msgid ""
"We'll be using the following XML document as the sample data for this "
"section:"
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:78
msgid "We can import this data by reading from a file::"
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:84
msgid "Or directly from a string::"
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:88
msgid ""
":func:`fromstring` parses XML from a string directly into an :class:"
"`Element`, which is the root element of the parsed tree.  Other parsing "
"functions may create an :class:`ElementTree`.  Check the documentation to be "
"sure."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:92
msgid ""
"As an :class:`Element`, ``root`` has a tag and a dictionary of attributes::"
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:99
msgid "It also has children nodes over which we can iterate::"
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:108
msgid "Children are nested, and we can access specific child nodes by index::"
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:116
msgid ""
"Not all elements of the XML input will end up as elements of the parsed "
"tree. Currently, this module skips over any XML comments, processing "
"instructions, and document type declarations in the input. Nevertheless, "
"trees built using this module's API rather than parsing from XML text can "
"have comments and processing instructions in them; they will be included "
"when generating XML output. A document type declaration may be accessed by "
"passing a custom :class:`TreeBuilder` instance to the :class:`XMLParser` "
"constructor."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:130
msgid "Pull API for non-blocking parsing"
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:132
msgid ""
"Most parsing functions provided by this module require the whole document to "
"be read at once before returning any result.  It is possible to use an :"
"class:`XMLParser` and feed data into it incrementally, but it is a push API "
"that calls methods on a callback target, which is too low-level and "
"inconvenient for most needs.  Sometimes what the user really wants is to be "
"able to parse XML incrementally, without blocking operations, while enjoying "
"the convenience of fully constructed :class:`Element` objects."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:140
msgid ""
"The most powerful tool for doing this is :class:`XMLPullParser`.  It does "
"not require a blocking read to obtain the XML data, and is instead fed with "
"data incrementally with :meth:`XMLPullParser.feed` calls.  To get the parsed "
"XML elements, call :meth:`XMLPullParser.read_events`.  Here is an example::"
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:156
msgid ""
"The obvious use case is applications that operate in a non-blocking fashion "
"where the XML data is being received from a socket or read incrementally "
"from some storage device.  In such cases, blocking reads are unacceptable."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:160
msgid ""
"Because it's so flexible, :class:`XMLPullParser` can be inconvenient to use "
"for simpler use-cases.  If you don't mind your application blocking on "
"reading XML data but would still like to have incremental parsing "
"capabilities, take a look at :func:`iterparse`.  It can be useful when "
"you're reading a large XML document and don't want to hold it wholly in "
"memory."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:167
msgid "Finding interesting elements"
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:169
msgid ""
":class:`Element` has some useful methods that help iterate recursively over "
"all the sub-tree below it (its children, their children, and so on).  For "
"example, :meth:`Element.iter`::"
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:182
msgid ""
":meth:`Element.findall` finds only elements with a tag which are direct "
"children of the current element.  :meth:`Element.find` finds the *first* "
"child with a particular tag, and :attr:`Element.text` accesses the element's "
"text content.  :meth:`Element.get` accesses the element's attributes::"
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:196
msgid ""
"More sophisticated specification of which elements to look for is possible "
"by using :ref:`XPath <elementtree-xpath>`."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:200
msgid "Modifying an XML File"
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:202
msgid ""
":class:`ElementTree` provides a simple way to build XML documents and write "
"them to files. The :meth:`ElementTree.write` method serves this purpose."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:205
msgid ""
"Once created, an :class:`Element` object may be manipulated by directly "
"changing its fields (such as :attr:`Element.text`), adding and modifying "
"attributes (:meth:`Element.set` method), as well as adding new children (for "
"example with :meth:`Element.append`)."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:210
msgid ""
"Let's say we want to add one to each country's rank, and add an ``updated`` "
"attribute to the rank element::"
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:220
#: ../Doc/library/xml.etree.elementtree.rst:258
msgid "Our XML now looks like this:"
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:248
msgid ""
"We can remove elements using :meth:`Element.remove`.  Let's say we want to "
"remove all countries with a rank higher than 50::"
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:280
msgid "Building XML documents"
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:282
msgid ""
"The :func:`SubElement` function also provides a convenient way to create new "
"sub-elements for a given element::"
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:293
msgid "Parsing XML with Namespaces"
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:295
msgid ""
"If the XML input has `namespaces <https://en.wikipedia.org/wiki/"
"XML_namespace>`__, tags and attributes with prefixes in the form ``prefix:"
"sometag`` get expanded to ``{uri}sometag`` where the *prefix* is replaced by "
"the full *URI*. Also, if there is a `default namespace <https://www.w3.org/"
"TR/xml-names/#defaulting>`__, that full URI gets prepended to all of the non-"
"prefixed tags."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:303
msgid ""
"Here is an XML example that incorporates two namespaces, one with the prefix "
"\"fictional\" and the other serving as the default namespace:"
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:324
msgid ""
"One way to search and explore this XML example is to manually add the URI to "
"every tag or attribute in the xpath of a :meth:`~Element.find` or :meth:"
"`~Element.findall`::"
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:335
msgid ""
"A better way to search the namespaced XML example is to create a dictionary "
"with your own prefixes and use those in the search functions::"
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:347
msgid "These two approaches both output::"
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:359
msgid "Additional resources"
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:361
msgid ""
"See http://effbot.org/zone/element-index.htm for tutorials and links to "
"other docs."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:368
msgid "XPath support"
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:370
msgid ""
"This module provides limited support for `XPath expressions <https://www.w3."
"org/TR/xpath>`_ for locating elements in a tree.  The goal is to support a "
"small subset of the abbreviated syntax; a full XPath engine is outside the "
"scope of the module."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:376
#: ../Doc/library/xml.etree.elementtree.rst:738
msgid "Example"
msgstr "Exemple"

#: ../Doc/library/xml.etree.elementtree.rst:378
msgid ""
"Here's an example that demonstrates some of the XPath capabilities of the "
"module.  We'll be using the ``countrydata`` XML document from the :ref:"
"`Parsing XML <elementtree-parsing-xml>` section::"
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:402
msgid ""
"For XML with namespaces, use the usual qualified ``{namespace}tag`` "
"notation::"
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:409
msgid "Supported XPath syntax"
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:414
msgid "Syntax"
msgstr "Syntaxe"

#: ../Doc/library/xml.etree.elementtree.rst:414
msgid "Meaning"
msgstr "Signification"

#: ../Doc/library/xml.etree.elementtree.rst:416
msgid "``tag``"
msgstr "``tag``"

#: ../Doc/library/xml.etree.elementtree.rst:416
msgid ""
"Selects all child elements with the given tag. For example, ``spam`` selects "
"all child elements named ``spam``, and ``spam/egg`` selects all "
"grandchildren named ``egg`` in all children named ``spam``.  ``{namespace}"
"*`` selects all tags in the given namespace, ``{*}spam`` selects tags named "
"``spam`` in any (or no) namespace, and ``{}*`` only selects tags that are "
"not in a namespace."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:425
msgid "Support for star-wildcards was added."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:428
msgid "``*``"
msgstr "``*``"

#: ../Doc/library/xml.etree.elementtree.rst:428
msgid ""
"Selects all child elements, including comments and processing instructions.  "
"For example, ``*/egg`` selects all grandchildren named ``egg``."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:432
msgid "``.``"
msgstr "``.``"

#: ../Doc/library/xml.etree.elementtree.rst:432
msgid ""
"Selects the current node.  This is mostly useful at the beginning of the "
"path, to indicate that it's a relative path."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:436
msgid "``//``"
msgstr "``//``"

#: ../Doc/library/xml.etree.elementtree.rst:436
msgid ""
"Selects all subelements, on all levels beneath the current  element.  For "
"example, ``.//egg`` selects all ``egg`` elements in the entire tree."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:440
msgid "``..``"
msgstr "``..``"

#: ../Doc/library/xml.etree.elementtree.rst:440
msgid ""
"Selects the parent element.  Returns ``None`` if the path attempts to reach "
"the ancestors of the start element (the element ``find`` was called on)."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:444
msgid "``[@attrib]``"
msgstr "``[@attrib]``"

#: ../Doc/library/xml.etree.elementtree.rst:444
msgid "Selects all elements that have the given attribute."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:446
msgid "``[@attrib='value']``"
msgstr "``[@attrib='value']``"

#: ../Doc/library/xml.etree.elementtree.rst:446
msgid ""
"Selects all elements for which the given attribute has the given value.  The "
"value cannot contain quotes."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:450
msgid "``[tag]``"
msgstr "``[tag]``"

#: ../Doc/library/xml.etree.elementtree.rst:450
msgid ""
"Selects all elements that have a child named ``tag``.  Only immediate "
"children are supported."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:453
msgid "``[.='text']``"
msgstr "``[.='text']``"

#: ../Doc/library/xml.etree.elementtree.rst:453
msgid ""
"Selects all elements whose complete text content, including descendants, "
"equals the given ``text``."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:458
msgid "``[tag='text']``"
msgstr "``[tag='text']``"

#: ../Doc/library/xml.etree.elementtree.rst:458
msgid ""
"Selects all elements that have a child named ``tag`` whose complete text "
"content, including descendants, equals the given ``text``."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:462
msgid "``[position]``"
msgstr "``[position]``"

#: ../Doc/library/xml.etree.elementtree.rst:462
msgid ""
"Selects all elements that are located at the given position.  The position "
"can be either an integer (1 is the first position), the expression "
"``last()`` (for the last position), or a position relative to the last "
"position (e.g. ``last()-1``)."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:469
msgid ""
"Predicates (expressions within square brackets) must be preceded by a tag "
"name, an asterisk, or another predicate.  ``position`` predicates must be "
"preceded by a tag name."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:474
#: ../Doc/library/xml.etree.elementtree.rst:790
msgid "Reference"
msgstr "Référence"

#: ../Doc/library/xml.etree.elementtree.rst:479
#: ../Doc/library/xml.etree.elementtree.rst:795
msgid "Functions"
msgstr "Fonctions"

#: ../Doc/library/xml.etree.elementtree.rst:483
msgid "`C14N 2.0 <https://www.w3.org/TR/xml-c14n2/>`_ transformation function."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:485
msgid ""
"Canonicalization is a way to normalise XML output in a way that allows byte-"
"by-byte comparisons and digital signatures.  It reduced the freedom that XML "
"serializers have and instead generates a more constrained XML "
"representation.  The main restrictions regard the placement of namespace "
"declarations, the ordering of attributes, and ignorable whitespace."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:491
msgid ""
"This function takes an XML data string (*xml_data*) or a file path or file-"
"like object (*from_file*) as input, converts it to the canonical form, and "
"writes it out using the *out* file(-like) object, if provided, or returns it "
"as a text string if not.  The output file receives text, not bytes.  It "
"should therefore be opened in text mode with ``utf-8`` encoding."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:498
msgid "Typical uses::"
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:509
msgid "The configuration *options* are as follows:"
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:511
msgid "*with_comments*: set to true to include comments (default: false)"
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:512
msgid ""
"*strip_text*: set to true to strip whitespace before and after text content"
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:513
#: ../Doc/library/xml.etree.elementtree.rst:515
msgid "(default: false)"
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:514
msgid ""
"*rewrite_prefixes*: set to true to replace namespace prefixes by "
"\"n{number}\""
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:516
msgid "*qname_aware_tags*: a set of qname aware tag names in which prefixes"
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:517
#: ../Doc/library/xml.etree.elementtree.rst:519
msgid "should be replaced in text content (default: empty)"
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:518
msgid ""
"*qname_aware_attrs*: a set of qname aware attribute names in which prefixes"
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:520
msgid "*exclude_attrs*: a set of attribute names that should not be serialised"
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:521
msgid "*exclude_tags*: a set of tag names that should not be serialised"
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:523
msgid ""
"In the option list above, \"a set\" refers to any collection or iterable of "
"strings, no ordering is expected."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:531
msgid ""
"Comment element factory.  This factory function creates a special element "
"that will be serialized as an XML comment by the standard serializer.  The "
"comment string can be either a bytestring or a Unicode string.  *text* is a "
"string containing the comment string.  Returns an element instance "
"representing a comment."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:537
msgid ""
"Note that :class:`XMLParser` skips over comments in the input instead of "
"creating comment objects for them. An :class:`ElementTree` will only contain "
"comment nodes if they have been inserted into to the tree using one of the :"
"class:`Element` methods."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:544
msgid ""
"Writes an element tree or element structure to sys.stdout.  This function "
"should be used for debugging only."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:547
msgid ""
"The exact output format is implementation dependent.  In this version, it's "
"written as an ordinary XML file."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:550
msgid "*elem* is an element tree or an individual element."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:552
msgid ""
"The :func:`dump` function now preserves the attribute order specified by the "
"user."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:559
msgid ""
"Parses an XML section from a string constant.  Same as :func:`XML`.  *text* "
"is a string containing XML data.  *parser* is an optional parser instance. "
"If not given, the standard :class:`XMLParser` parser is used. Returns an :"
"class:`Element` instance."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:567
msgid ""
"Parses an XML document from a sequence of string fragments.  *sequence* is a "
"list or other sequence containing XML data fragments.  *parser* is an "
"optional parser instance.  If not given, the standard :class:`XMLParser` "
"parser is used.  Returns an :class:`Element` instance."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:577
msgid ""
"Check if an object appears to be a valid element object.  *element* is an "
"element instance.  Return ``True`` if this is an element object."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:583
msgid ""
"Parses an XML section into an element tree incrementally, and reports what's "
"going on to the user.  *source* is a filename or :term:`file object` "
"containing XML data.  *events* is a sequence of events to report back.  The "
"supported events are the strings ``\"start\"``, ``\"end\"``, ``\"comment"
"\"``, ``\"pi\"``, ``\"start-ns\"`` and ``\"end-ns\"`` (the \"ns\" events are "
"used to get detailed namespace information).  If *events* is omitted, only ``"
"\"end\"`` events are reported. *parser* is an optional parser instance.  If "
"not given, the standard :class:`XMLParser` parser is used.  *parser* must be "
"a subclass of :class:`XMLParser` and can only use the default :class:"
"`TreeBuilder` as a target.  Returns an :term:`iterator` providing ``(event, "
"elem)`` pairs."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:595
msgid ""
"Note that while :func:`iterparse` builds the tree incrementally, it issues "
"blocking reads on *source* (or the file it names).  As such, it's unsuitable "
"for applications where blocking reads can't be made.  For fully non-blocking "
"parsing, see :class:`XMLPullParser`."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:602
msgid ""
":func:`iterparse` only guarantees that it has seen the \">\" character of a "
"starting tag when it emits a \"start\" event, so the attributes are defined, "
"but the contents of the text and tail attributes are undefined at that "
"point.  The same applies to the element children; they may or may not be "
"present."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:608
#: ../Doc/library/xml.etree.elementtree.rst:1445
msgid "If you need a fully populated element, look for \"end\" events instead."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:610
msgid "The *parser* argument."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:613
#: ../Doc/library/xml.etree.elementtree.rst:1449
msgid "The ``comment`` and ``pi`` events were added."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:619
msgid ""
"Parses an XML section into an element tree.  *source* is a filename or file "
"object containing XML data.  *parser* is an optional parser instance.  If "
"not given, the standard :class:`XMLParser` parser is used.  Returns an :"
"class:`ElementTree` instance."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:627
msgid ""
"PI element factory.  This factory function creates a special element that "
"will be serialized as an XML processing instruction.  *target* is a string "
"containing the PI target.  *text* is a string containing the PI contents, if "
"given.  Returns an element instance, representing a processing instruction."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:632
msgid ""
"Note that :class:`XMLParser` skips over processing instructions in the input "
"instead of creating comment objects for them. An :class:`ElementTree` will "
"only contain processing instruction nodes if they have been inserted into to "
"the tree using one of the :class:`Element` methods."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:640
msgid ""
"Registers a namespace prefix.  The registry is global, and any existing "
"mapping for either the given prefix or the namespace URI will be removed. "
"*prefix* is a namespace prefix.  *uri* is a namespace uri.  Tags and "
"attributes in this namespace will be serialized with the given prefix, if at "
"all possible."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:651
msgid ""
"Subelement factory.  This function creates an element instance, and appends "
"it to an existing element."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:654
msgid ""
"The element name, attribute names, and attribute values can be either "
"bytestrings or Unicode strings.  *parent* is the parent element.  *tag* is "
"the subelement name.  *attrib* is an optional dictionary, containing element "
"attributes.  *extra* contains additional attributes, given as keyword "
"arguments.  Returns an element instance."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:665
msgid ""
"Generates a string representation of an XML element, including all "
"subelements.  *element* is an :class:`Element` instance.  *encoding* [1]_ is "
"the output encoding (default is US-ASCII).  Use ``encoding=\"unicode\"`` to "
"generate a Unicode string (otherwise, a bytestring is generated).  *method* "
"is either ``\"xml\"``, ``\"html\"`` or ``\"text\"`` (default is ``\"xml"
"\"``). *xml_declaration*, *default_namespace* and *short_empty_elements* has "
"the same meaning as in :meth:`ElementTree.write`. Returns an (optionally) "
"encoded string containing the XML data."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:674
#: ../Doc/library/xml.etree.elementtree.rst:701
#: ../Doc/library/xml.etree.elementtree.rst:1157
msgid "The *short_empty_elements* parameter."
msgstr "Le paramètre *short_empty_elements*."

#: ../Doc/library/xml.etree.elementtree.rst:677
#: ../Doc/library/xml.etree.elementtree.rst:704
msgid "The *xml_declaration* and *default_namespace* parameters."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:680
msgid ""
"The :func:`tostring` function now preserves the attribute order specified by "
"the user."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:689
msgid ""
"Generates a string representation of an XML element, including all "
"subelements.  *element* is an :class:`Element` instance.  *encoding* [1]_ is "
"the output encoding (default is US-ASCII).  Use ``encoding=\"unicode\"`` to "
"generate a Unicode string (otherwise, a bytestring is generated).  *method* "
"is either ``\"xml\"``, ``\"html\"`` or ``\"text\"`` (default is ``\"xml"
"\"``). *xml_declaration*, *default_namespace* and *short_empty_elements* has "
"the same meaning as in :meth:`ElementTree.write`. Returns a list of "
"(optionally) encoded strings containing the XML data. It does not guarantee "
"any specific sequence, except that ``b\"\".join(tostringlist(element)) == "
"tostring(element)``."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:707
msgid ""
"The :func:`tostringlist` function now preserves the attribute order "
"specified by the user."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:714
msgid ""
"Parses an XML section from a string constant.  This function can be used to "
"embed \"XML literals\" in Python code.  *text* is a string containing XML "
"data.  *parser* is an optional parser instance.  If not given, the standard :"
"class:`XMLParser` parser is used.  Returns an :class:`Element` instance."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:722
msgid ""
"Parses an XML section from a string constant, and also returns a dictionary "
"which maps from element id:s to elements.  *text* is a string containing XML "
"data.  *parser* is an optional parser instance.  If not given, the standard :"
"class:`XMLParser` parser is used.  Returns a tuple containing an :class:"
"`Element` instance and a dictionary."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:732
msgid "XInclude support"
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:734
msgid ""
"This module provides limited support for `XInclude directives <https://www."
"w3.org/TR/xinclude/>`_, via the :mod:`xml.etree.ElementInclude` helper "
"module.  This module can be used to insert subtrees and text strings into "
"element trees, based on information in the tree."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:740
msgid ""
"Here's an example that demonstrates use of the XInclude module. To include "
"an XML document in the current document, use the ``{http://www.w3.org/2001/"
"XInclude}include`` element and set the **parse** attribute to ``\"xml\"``, "
"and use the **href** attribute to specify the document to include."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:749
msgid ""
"By default, the **href** attribute is treated as a file name. You can use "
"custom loaders to override this behaviour. Also note that the standard "
"helper does not support XPointer syntax."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:751
msgid ""
"To process this file, load it as usual, and pass the root element to the :"
"mod:`xml.etree.ElementTree` module:"
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:762
msgid ""
"The ElementInclude module replaces the ``{http://www.w3.org/2001/XInclude}"
"include`` element with the root element from the **source.xml** document. "
"The result might look something like this:"
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:770
msgid ""
"If the **parse** attribute is omitted, it defaults to \"xml\". The href "
"attribute is required."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:772
msgid ""
"To include a text document, use the ``{http://www.w3.org/2001/XInclude}"
"include`` element, and set the **parse** attribute to \"text\":"
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:781
msgid "The result might look something like:"
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:799
msgid ""
"Default loader. This default loader reads an included resource from disk.  "
"*href* is a URL. *parse* is for parse mode either \"xml\" or \"text\".  "
"*encoding* is an optional text encoding.  If not given, encoding is "
"``utf-8``.  Returns the expanded resource.  If the parse mode is ``\"xml"
"\"``, this is an ElementTree instance.  If the parse mode is \"text\", this "
"is a Unicode string.  If the loader fails, it can return None or raise an "
"exception."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:809
msgid ""
"This function expands XInclude directives.  *elem* is the root element.  "
"*loader* is an optional resource loader.  If omitted, it defaults to :func:"
"`default_loader`. If given, it should be a callable that implements the same "
"interface as :func:`default_loader`.  Returns the expanded resource.  If the "
"parse mode is ``\"xml\"``, this is an ElementTree instance.  If the parse "
"mode is \"text\", this is a Unicode string.  If the loader fails, it can "
"return None or raise an exception."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:821
msgid "Element Objects"
msgstr "Objets Elements"

#: ../Doc/library/xml.etree.elementtree.rst:825
msgid ""
"Element class.  This class defines the Element interface, and provides a "
"reference implementation of this interface."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:828
msgid ""
"The element name, attribute names, and attribute values can be either "
"bytestrings or Unicode strings.  *tag* is the element name.  *attrib* is an "
"optional dictionary, containing element attributes.  *extra* contains "
"additional attributes, given as keyword arguments."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:836
msgid ""
"A string identifying what kind of data this element represents (the element "
"type, in other words)."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:843
msgid ""
"These attributes can be used to hold additional data associated with the "
"element.  Their values are usually strings but may be any application-"
"specific object.  If the element is created from an XML file, the *text* "
"attribute holds either the text between the element's start tag and its "
"first child or end tag, or ``None``, and the *tail* attribute holds either "
"the text between the element's end tag and the next tag, or ``None``.  For "
"the XML data"
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:855
msgid ""
"the *a* element has ``None`` for both *text* and *tail* attributes, the *b* "
"element has *text* ``\"1\"`` and *tail* ``\"4\"``, the *c* element has "
"*text* ``\"2\"`` and *tail* ``None``, and the *d* element has *text* "
"``None`` and *tail* ``\"3\"``."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:860
msgid ""
"To collect the inner text of an element, see :meth:`itertext`, for example ``"
"\"\".join(element.itertext())``."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:863
msgid "Applications may store arbitrary objects in these attributes."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:868
msgid ""
"A dictionary containing the element's attributes.  Note that while the "
"*attrib* value is always a real mutable Python dictionary, an ElementTree "
"implementation may choose to use another internal representation, and create "
"the dictionary only if someone asks for it.  To take advantage of such "
"implementations, use the dictionary methods below whenever possible."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:874
msgid "The following dictionary-like methods work on the element attributes."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:879
msgid ""
"Resets an element.  This function removes all subelements, clears all "
"attributes, and sets the text and tail attributes to ``None``."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:885
msgid "Gets the element attribute named *key*."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:887
msgid ""
"Returns the attribute value, or *default* if the attribute was not found."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:892
msgid ""
"Returns the element attributes as a sequence of (name, value) pairs.  The "
"attributes are returned in an arbitrary order."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:898
msgid ""
"Returns the elements attribute names as a list.  The names are returned in "
"an arbitrary order."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:904
msgid "Set the attribute *key* on the element to *value*."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:906
msgid "The following methods work on the element's children (subelements)."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:911
msgid ""
"Adds the element *subelement* to the end of this element's internal list of "
"subelements.  Raises :exc:`TypeError` if *subelement* is not an :class:"
"`Element`."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:918
msgid ""
"Appends *subelements* from a sequence object with zero or more elements. "
"Raises :exc:`TypeError` if a subelement is not an :class:`Element`."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:926
msgid ""
"Finds the first subelement matching *match*.  *match* may be a tag name or "
"a :ref:`path <elementtree-xpath>`.  Returns an element instance or "
"``None``.  *namespaces* is an optional mapping from namespace prefix to full "
"name.  Pass ``''`` as prefix to move all unprefixed tag names in the "
"expression into the given namespace."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:935
msgid ""
"Finds all matching subelements, by tag name or :ref:`path <elementtree-"
"xpath>`.  Returns a list containing all matching elements in document "
"order.  *namespaces* is an optional mapping from namespace prefix to full "
"name.  Pass ``''`` as prefix to move all unprefixed tag names in the "
"expression into the given namespace."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:944
msgid ""
"Finds text for the first subelement matching *match*.  *match* may be a tag "
"name or a :ref:`path <elementtree-xpath>`.  Returns the text content of the "
"first matching element, or *default* if no element was found. Note that if "
"the matching element has no text content an empty string is returned. "
"*namespaces* is an optional mapping from namespace prefix to full name.  "
"Pass ``''`` as prefix to move all unprefixed tag names in the expression "
"into the given namespace."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:956
msgid "Use ``list(elem)`` or iteration."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:962
msgid "Use method :meth:`Element.iter` instead."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:967
msgid ""
"Inserts *subelement* at the given position in this element.  Raises :exc:"
"`TypeError` if *subelement* is not an :class:`Element`."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:973
msgid ""
"Creates a tree :term:`iterator` with the current element as the root. The "
"iterator iterates over this element and all elements below it, in document "
"(depth first) order.  If *tag* is not ``None`` or ``'*'``, only elements "
"whose tag equals *tag* are returned from the iterator.  If the tree "
"structure is modified during iteration, the result is undefined."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:984
msgid ""
"Finds all matching subelements, by tag name or :ref:`path <elementtree-"
"xpath>`.  Returns an iterable yielding all matching elements in document "
"order. *namespaces* is an optional mapping from namespace prefix to full "
"name."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:995
msgid ""
"Creates a text iterator.  The iterator loops over this element and all "
"subelements, in document order, and returns all inner text."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:1003
msgid ""
"Creates a new element object of the same type as this element.  Do not call "
"this method, use the :func:`SubElement` factory function instead."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:1009
msgid ""
"Removes *subelement* from the element.  Unlike the find\\* methods this "
"method compares elements based on the instance identity, not on tag value or "
"contents."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:1013
msgid ""
":class:`Element` objects also support the following sequence type methods "
"for working with subelements: :meth:`~object.__delitem__`, :meth:`~object."
"__getitem__`, :meth:`~object.__setitem__`, :meth:`~object.__len__`."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:1018
msgid ""
"Caution: Elements with no subelements will test as ``False``.  This behavior "
"will change in future versions.  Use specific ``len(elem)`` or ``elem is "
"None`` test instead. ::"
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:1030
msgid ""
"Prior to Python 3.8, the serialisation order of the XML attributes of "
"elements was artificially made predictable by sorting the attributes by "
"their name. Based on the now guaranteed ordering of dicts, this arbitrary "
"reordering was removed in Python 3.8 to preserve the order in which "
"attributes were originally parsed or created by user code."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:1036
msgid ""
"In general, user code should try not to depend on a specific ordering of "
"attributes, given that the `XML Information Set <https://www.w3.org/TR/xml-"
"infoset/>`_ explicitly excludes the attribute order from conveying "
"information. Code should be prepared to deal with any ordering on input. In "
"cases where deterministic XML output is required, e.g. for cryptographic "
"signing or test data sets, canonical serialisation is available with the :"
"func:`canonicalize` function."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:1044
msgid ""
"In cases where canonical output is not applicable but a specific attribute "
"order is still desirable on output, code should aim for creating the "
"attributes directly in the desired order, to avoid perceptual mismatches for "
"readers of the code. In cases where this is difficult to achieve, a recipe "
"like the following can be applied prior to serialisation to enforce an order "
"independently from the Element creation::"
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:1064
msgid "ElementTree Objects"
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:1069
msgid ""
"ElementTree wrapper class.  This class represents an entire element "
"hierarchy, and adds some extra support for serialization to and from "
"standard XML."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:1073
msgid ""
"*element* is the root element.  The tree is initialized with the contents of "
"the XML *file* if given."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:1079
msgid ""
"Replaces the root element for this tree.  This discards the current contents "
"of the tree, and replaces it with the given element.  Use with care.  "
"*element* is an element instance."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:1086
msgid "Same as :meth:`Element.find`, starting at the root of the tree."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:1091
msgid "Same as :meth:`Element.findall`, starting at the root of the tree."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:1096
msgid "Same as :meth:`Element.findtext`, starting at the root of the tree."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:1102
msgid "Use method :meth:`ElementTree.iter` instead."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:1107
msgid "Returns the root element for this tree."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:1112
msgid ""
"Creates and returns a tree iterator for the root element.  The iterator "
"loops over all elements in this tree, in section order.  *tag* is the tag to "
"look for (default is to return all elements)."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:1119
msgid "Same as :meth:`Element.iterfind`, starting at the root of the tree."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:1126
msgid ""
"Loads an external XML section into this element tree.  *source* is a file "
"name or :term:`file object`.  *parser* is an optional parser instance. If "
"not given, the standard :class:`XMLParser` parser is used.  Returns the "
"section root element."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:1136
msgid ""
"Writes the element tree to a file, as XML.  *file* is a file name, or a :"
"term:`file object` opened for writing.  *encoding* [1]_ is the output "
"encoding (default is US-ASCII). *xml_declaration* controls if an XML "
"declaration should be added to the file.  Use ``False`` for never, ``True`` "
"for always, ``None`` for only if not US-ASCII or UTF-8 or Unicode (default "
"is ``None``). *default_namespace* sets the default XML namespace (for \"xmlns"
"\"). *method* is either ``\"xml\"``, ``\"html\"`` or ``\"text\"`` (default "
"is ``\"xml\"``). The keyword-only *short_empty_elements* parameter controls "
"the formatting of elements that contain no content.  If ``True`` (the "
"default), they are emitted as a single self-closed tag, otherwise they are "
"emitted as a pair of start/end tags."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:1150
msgid ""
"The output is either a string (:class:`str`) or binary (:class:`bytes`). "
"This is controlled by the *encoding* argument.  If *encoding* is ``\"unicode"
"\"``, the output is a string; otherwise, it's binary.  Note that this may "
"conflict with the type of *file* if it's an open :term:`file object`; make "
"sure you do not try to write a string to a binary stream and vice versa."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:1160
msgid ""
"The :meth:`write` method now preserves the attribute order specified by the "
"user."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:1165
msgid "This is the XML file that is going to be manipulated::"
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:1177
msgid ""
"Example of changing the attribute \"target\" of every link in first "
"paragraph::"
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:1196
msgid "QName Objects"
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:1201
msgid ""
"QName wrapper.  This can be used to wrap a QName attribute value, in order "
"to get proper namespace handling on output.  *text_or_uri* is a string "
"containing the QName value, in the form {uri}local, or, if the tag argument "
"is given, the URI part of a QName.  If *tag* is given, the first argument is "
"interpreted as a URI, and this argument is interpreted as a local name. :"
"class:`QName` instances are opaque."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:1213
msgid "TreeBuilder Objects"
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:1219
msgid ""
"Generic element structure builder.  This builder converts a sequence of "
"start, data, end, comment and pi method calls to a well-formed element "
"structure.  You can use this class to build an element structure using a "
"custom XML parser, or a parser for some other XML-like format."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:1224
msgid ""
"*element_factory*, when given, must be a callable accepting two positional "
"arguments: a tag and a dict of attributes.  It is expected to return a new "
"element instance."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:1228
msgid ""
"The *comment_factory* and *pi_factory* functions, when given, should behave "
"like the :func:`Comment` and :func:`ProcessingInstruction` functions to "
"create comments and processing instructions.  When not given, the default "
"factories will be used.  When *insert_comments* and/or *insert_pis* is true, "
"comments/pis will be inserted into the tree if they appear within the root "
"element (but not outside of it)."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:1237
msgid ""
"Flushes the builder buffers, and returns the toplevel document element.  "
"Returns an :class:`Element` instance."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:1243
msgid ""
"Adds text to the current element.  *data* is a string.  This should be "
"either a bytestring, or a Unicode string."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:1249
msgid ""
"Closes the current element.  *tag* is the element name.  Returns the closed "
"element."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:1255
msgid ""
"Opens a new element.  *tag* is the element name.  *attrs* is a dictionary "
"containing element attributes.  Returns the opened element."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:1261
msgid ""
"Creates a comment with the given *text*.  If ``insert_comments`` is true, "
"this will also add it to the tree."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:1269
msgid ""
"Creates a comment with the given *target* name and *text*.  If "
"``insert_pis`` is true, this will also add it to the tree."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:1275
msgid ""
"In addition, a custom :class:`TreeBuilder` object can provide the following "
"methods:"
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:1280
msgid ""
"Handles a doctype declaration.  *name* is the doctype name.  *pubid* is the "
"public identifier.  *system* is the system identifier.  This method does not "
"exist on the default :class:`TreeBuilder` class."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:1288
msgid ""
"Is called whenever the parser encounters a new namespace declaration, before "
"the ``start()`` callback for the opening element that defines it. *prefix* "
"is ``''`` for the default namespace and the declared namespace prefix name "
"otherwise.  *uri* is the namespace URI."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:1297
msgid ""
"Is called after the ``end()`` callback of an element that declared a "
"namespace prefix mapping, with the name of the *prefix* that went out of "
"scope."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:1309
msgid ""
"A `C14N 2.0 <https://www.w3.org/TR/xml-c14n2/>`_ writer.  Arguments are the "
"same as for the :func:`canonicalize` function.  This class does not build a "
"tree but translates the callback events directly into a serialised form "
"using the *write* function."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:1320
msgid "XMLParser Objects"
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:1325
msgid ""
"This class is the low-level building block of the module.  It uses :mod:`xml."
"parsers.expat` for efficient, event-based parsing of XML.  It can be fed XML "
"data incrementally with the :meth:`feed` method, and parsing events are "
"translated to a push API - by invoking callbacks on the *target* object.  If "
"*target* is omitted, the standard :class:`TreeBuilder` is used. If "
"*encoding* [1]_ is given, the value overrides the encoding specified in the "
"XML file."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:1333
msgid ""
"Parameters are now :ref:`keyword-only <keyword-only_parameter>`. The *html* "
"argument no longer supported."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:1340
msgid ""
"Finishes feeding data to the parser.  Returns the result of calling the "
"``close()`` method of the *target* passed during construction; by default, "
"this is the toplevel document element."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:1347
msgid "Feeds data to the parser.  *data* is encoded data."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:1349
msgid ""
":meth:`XMLParser.feed` calls *target*\\'s ``start(tag, attrs_dict)`` method "
"for each opening tag, its ``end(tag)`` method for each closing tag, and data "
"is processed by method ``data(data)``.  For further supported callback "
"methods, see the :class:`TreeBuilder` class.  :meth:`XMLParser.close` calls "
"*target*\\'s method ``close()``. :class:`XMLParser` can be used not only for "
"building a tree structure. This is an example of counting the maximum depth "
"of an XML file::"
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:1393
msgid "XMLPullParser Objects"
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:1397
msgid ""
"A pull parser suitable for non-blocking applications.  Its input-side API is "
"similar to that of :class:`XMLParser`, but instead of pushing calls to a "
"callback target, :class:`XMLPullParser` collects an internal list of parsing "
"events and lets the user read from it. *events* is a sequence of events to "
"report back.  The supported events are the strings ``\"start\"``, ``\"end"
"\"``, ``\"comment\"``, ``\"pi\"``, ``\"start-ns\"`` and ``\"end-ns\"`` (the "
"\"ns\" events are used to get detailed namespace information).  If *events* "
"is omitted, only ``\"end\"`` events are reported."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:1408
msgid "Feed the given bytes data to the parser."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:1412
msgid ""
"Signal the parser that the data stream is terminated. Unlike :meth:"
"`XMLParser.close`, this method always returns :const:`None`. Any events not "
"yet retrieved when the parser is closed can still be read with :meth:"
"`read_events`."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:1419
msgid ""
"Return an iterator over the events which have been encountered in the data "
"fed to the parser.  The iterator yields ``(event, elem)`` pairs, where "
"*event* is a string representing the type of event (e.g. ``\"end\"``) and "
"*elem* is the encountered :class:`Element` object, or other context value as "
"follows."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:1425
msgid "``start``, ``end``: the current Element."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:1426
msgid "``comment``, ``pi``: the current comment / processing instruction"
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:1427
msgid ""
"``start-ns``: a tuple ``(prefix, uri)`` naming the declared namespace "
"mapping."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:1429
msgid "``end-ns``: :const:`None` (this may change in a future version)"
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:1431
msgid ""
"Events provided in a previous call to :meth:`read_events` will not be "
"yielded again.  Events are consumed from the internal queue only when they "
"are retrieved from the iterator, so multiple readers iterating in parallel "
"over iterators obtained from :meth:`read_events` will have unpredictable "
"results."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:1439
msgid ""
":class:`XMLPullParser` only guarantees that it has seen the \">\" character "
"of a starting tag when it emits a \"start\" event, so the attributes are "
"defined, but the contents of the text and tail attributes are undefined at "
"that point.  The same applies to the element children; they may or may not "
"be present."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:1454
msgid "Exceptions"
msgstr "Exceptions"

#: ../Doc/library/xml.etree.elementtree.rst:1458
msgid ""
"XML parse error, raised by the various parsing methods in this module when "
"parsing fails.  The string representation of an instance of this exception "
"will contain a user-friendly error message.  In addition, it will have the "
"following attributes available:"
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:1465
msgid ""
"A numeric error code from the expat parser. See the documentation of :mod:"
"`xml.parsers.expat` for the list of error codes and their meanings."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:1470
msgid ""
"A tuple of *line*, *column* numbers, specifying where the error occurred."
msgstr ""

#: ../Doc/library/xml.etree.elementtree.rst:1473
msgid "Footnotes"
msgstr "Notes"

#: ../Doc/library/xml.etree.elementtree.rst:1474
msgid ""
"The encoding string included in XML output should conform to the appropriate "
"standards.  For example, \"UTF-8\" is valid, but \"UTF8\" is not.  See "
"https://www.w3.org/TR/2006/REC-xml11-20060816/#NT-EncodingDecl and https://"
"www.iana.org/assignments/character-sets/character-sets.xhtml."
msgstr ""