forked from AFPy/python-docs-fr
969 lines
33 KiB
Plaintext
969 lines
33 KiB
Plaintext
# SOME DESCRIPTIVE TITLE.
|
|
# Copyright (C) 1990-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 2.7\n"
|
|
"Report-Msgid-Bugs-To: \n"
|
|
"POT-Creation-Date: 2016-10-30 10:44+0100\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"
|
|
"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:11
|
|
msgid "**Source code:** :source:`Lib/xml/etree/ElementTree.py`"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.etree.elementtree.rst:15
|
|
msgid ""
|
|
"The :class:`Element` type is a flexible container object, designed to store "
|
|
"hierarchical data structures in memory. The type can be described as a "
|
|
"cross between a list and a dictionary."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.etree.elementtree.rst:22
|
|
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:27
|
|
msgid "Each element has a number of properties associated with it:"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.etree.elementtree.rst:29
|
|
msgid ""
|
|
"a tag which is a string identifying what kind of data this element "
|
|
"represents (the element type, in other words)."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.etree.elementtree.rst:32
|
|
msgid "a number of attributes, stored in a Python dictionary."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.etree.elementtree.rst:34
|
|
msgid "a text string."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.etree.elementtree.rst:36
|
|
msgid "an optional tail string."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.etree.elementtree.rst:38
|
|
msgid "a number of child elements, stored in a Python sequence"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.etree.elementtree.rst:40
|
|
msgid ""
|
|
"To create an element instance, use the :class:`Element` constructor or the :"
|
|
"func:`SubElement` factory function."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.etree.elementtree.rst:43
|
|
msgid ""
|
|
"The :class:`ElementTree` class can be used to wrap an element structure, and "
|
|
"convert it from and to XML."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.etree.elementtree.rst:46
|
|
msgid ""
|
|
"A C implementation of this API is available as :mod:`xml.etree.cElementTree`."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.etree.elementtree.rst:48
|
|
msgid ""
|
|
"See http://effbot.org/zone/element-index.htm for tutorials and links to "
|
|
"other docs. Fredrik Lundh's page is also the location of the development "
|
|
"version of the xml.etree.ElementTree."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.etree.elementtree.rst:52
|
|
msgid ""
|
|
"The ElementTree API is updated to 1.3. For more information, see "
|
|
"`Introducing ElementTree 1.3 <http://effbot.org/zone/elementtree-13-intro."
|
|
"htm>`_."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.etree.elementtree.rst:58
|
|
msgid "Tutorial"
|
|
msgstr "Tutoriel"
|
|
|
|
#: ../Doc/library/xml.etree.elementtree.rst:60
|
|
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:65
|
|
msgid "XML tree and elements"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.etree.elementtree.rst:67
|
|
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:78
|
|
msgid "Parsing XML"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.etree.elementtree.rst:80
|
|
msgid ""
|
|
"We'll be using the following XML document as the sample data for this "
|
|
"section:"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.etree.elementtree.rst:108
|
|
msgid ""
|
|
"We have a number of ways to import the data. Reading the file from disk::"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.etree.elementtree.rst:114
|
|
msgid "Reading the data from a string::"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.etree.elementtree.rst:118
|
|
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:122
|
|
msgid ""
|
|
"As an :class:`Element`, ``root`` has a tag and a dictionary of attributes::"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.etree.elementtree.rst:129
|
|
msgid "It also has children nodes over which we can iterate::"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.etree.elementtree.rst:138
|
|
msgid "Children are nested, and we can access specific child nodes by index::"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.etree.elementtree.rst:144
|
|
msgid "Finding interesting elements"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.etree.elementtree.rst:146
|
|
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:159
|
|
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:173
|
|
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:177
|
|
msgid "Modifying an XML File"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.etree.elementtree.rst:179
|
|
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:182
|
|
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:187
|
|
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:197
|
|
#: ../Doc/library/xml.etree.elementtree.rst:235
|
|
msgid "Our XML now looks like this:"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.etree.elementtree.rst:225
|
|
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:257
|
|
msgid "Building XML documents"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.etree.elementtree.rst:259
|
|
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:270
|
|
msgid "Parsing XML with Namespaces"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.etree.elementtree.rst:272
|
|
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/2006/REC-xml-names-20060816/#defaulting>`__, that full URI gets prepended "
|
|
"to all of the non-prefixed tags."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.etree.elementtree.rst:280
|
|
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:301
|
|
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:313
|
|
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:325
|
|
msgid "These two approaches both output::"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.etree.elementtree.rst:337
|
|
msgid "Additional resources"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.etree.elementtree.rst:339
|
|
msgid ""
|
|
"See http://effbot.org/zone/element-index.htm for tutorials and links to "
|
|
"other docs."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.etree.elementtree.rst:345
|
|
msgid "XPath support"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.etree.elementtree.rst:347
|
|
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:353
|
|
msgid "Example"
|
|
msgstr "Exemple"
|
|
|
|
#: ../Doc/library/xml.etree.elementtree.rst:355
|
|
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:380
|
|
msgid "Supported XPath syntax"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.etree.elementtree.rst:385
|
|
msgid "Syntax"
|
|
msgstr "Syntaxe"
|
|
|
|
#: ../Doc/library/xml.etree.elementtree.rst:385
|
|
msgid "Meaning"
|
|
msgstr "Signification"
|
|
|
|
#: ../Doc/library/xml.etree.elementtree.rst:387
|
|
msgid "``tag``"
|
|
msgstr "``tag``"
|
|
|
|
#: ../Doc/library/xml.etree.elementtree.rst:387
|
|
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``."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.etree.elementtree.rst:393
|
|
msgid "``*``"
|
|
msgstr "``*``"
|
|
|
|
#: ../Doc/library/xml.etree.elementtree.rst:393
|
|
msgid ""
|
|
"Selects all child elements. For example, ``*/egg`` selects all "
|
|
"grandchildren named ``egg``."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.etree.elementtree.rst:396
|
|
msgid "``.``"
|
|
msgstr "``.``"
|
|
|
|
#: ../Doc/library/xml.etree.elementtree.rst:396
|
|
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:400
|
|
msgid "``//``"
|
|
msgstr "``//``"
|
|
|
|
#: ../Doc/library/xml.etree.elementtree.rst:400
|
|
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:404
|
|
msgid "``..``"
|
|
msgstr "``..``"
|
|
|
|
#: ../Doc/library/xml.etree.elementtree.rst:404
|
|
msgid "Selects the parent element."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.etree.elementtree.rst:406
|
|
msgid "``[@attrib]``"
|
|
msgstr "``[@attrib]``"
|
|
|
|
#: ../Doc/library/xml.etree.elementtree.rst:406
|
|
msgid "Selects all elements that have the given attribute."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.etree.elementtree.rst:408
|
|
msgid "``[@attrib='value']``"
|
|
msgstr "``[@attrib='value']``"
|
|
|
|
#: ../Doc/library/xml.etree.elementtree.rst:408
|
|
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:412
|
|
msgid "``[tag]``"
|
|
msgstr "``[tag]``"
|
|
|
|
#: ../Doc/library/xml.etree.elementtree.rst:412
|
|
msgid ""
|
|
"Selects all elements that have a child named ``tag``. Only immediate "
|
|
"children are supported."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.etree.elementtree.rst:415
|
|
msgid "``[tag='text']``"
|
|
msgstr "``[tag='text']``"
|
|
|
|
#: ../Doc/library/xml.etree.elementtree.rst:415
|
|
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:419
|
|
msgid "``[position]``"
|
|
msgstr "``[position]``"
|
|
|
|
#: ../Doc/library/xml.etree.elementtree.rst:419
|
|
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:426
|
|
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:431
|
|
msgid "Reference"
|
|
msgstr "Référence"
|
|
|
|
#: ../Doc/library/xml.etree.elementtree.rst:436
|
|
msgid "Functions"
|
|
msgstr "Fonctions"
|
|
|
|
#: ../Doc/library/xml.etree.elementtree.rst:441
|
|
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:450
|
|
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:453
|
|
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:456
|
|
msgid "*elem* is an element tree or an individual element."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.etree.elementtree.rst:461
|
|
msgid ""
|
|
"Parses an XML section from a string constant. Same as :func:`XML`. *text* "
|
|
"is a string containing XML data. Returns an :class:`Element` instance."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.etree.elementtree.rst:467
|
|
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:477
|
|
msgid ""
|
|
"Checks if an object appears to be a valid element object. *element* is an "
|
|
"element instance. Returns a true value if this is an element object."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.etree.elementtree.rst:483
|
|
msgid ""
|
|
"Parses an XML section into an element tree incrementally, and reports what's "
|
|
"going on to the user. *source* is a filename or file object containing XML "
|
|
"data. *events* is a list of events to report back. If omitted, only \"end"
|
|
"\" events are reported. *parser* is an optional parser instance. If not "
|
|
"given, the standard :class:`XMLParser` parser is used. *parser* is not "
|
|
"supported by ``cElementTree``. Returns an :term:`iterator` providing "
|
|
"``(event, elem)`` pairs."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.etree.elementtree.rst:493
|
|
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:499
|
|
msgid "If you need a fully populated element, look for \"end\" events instead."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.etree.elementtree.rst:504
|
|
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:512
|
|
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:520
|
|
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:531
|
|
msgid ""
|
|
"Subelement factory. This function creates an element instance, and appends "
|
|
"it to an existing element."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.etree.elementtree.rst:534
|
|
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:543
|
|
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). *method* is either ``\"xml\"``, "
|
|
"``\"html\"`` or ``\"text\"`` (default is ``\"xml\"``). Returns an encoded "
|
|
"string containing the XML data."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.etree.elementtree.rst:552
|
|
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). *method* is either ``\"xml\"``, "
|
|
"``\"html\"`` or ``\"text\"`` (default is ``\"xml\"``). Returns a list of "
|
|
"encoded strings containing the XML data. It does not guarantee any specific "
|
|
"sequence, except that ``\"\".join(tostringlist(element)) == "
|
|
"tostring(element)``."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.etree.elementtree.rst:565
|
|
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:573
|
|
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:583
|
|
msgid "Element Objects"
|
|
msgstr "Objets Elements"
|
|
|
|
#: ../Doc/library/xml.etree.elementtree.rst:587
|
|
msgid ""
|
|
"Element class. This class defines the Element interface, and provides a "
|
|
"reference implementation of this interface."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.etree.elementtree.rst:590
|
|
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:598
|
|
msgid ""
|
|
"A string identifying what kind of data this element represents (the element "
|
|
"type, in other words)."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.etree.elementtree.rst:605
|
|
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:617
|
|
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:622
|
|
msgid ""
|
|
"To collect the inner text of an element, see :meth:`itertext`, for example ``"
|
|
"\"\".join(element.itertext())``."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.etree.elementtree.rst:625
|
|
msgid "Applications may store arbitrary objects in these attributes."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.etree.elementtree.rst:630
|
|
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:636
|
|
msgid "The following dictionary-like methods work on the element attributes."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.etree.elementtree.rst:641
|
|
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:647
|
|
msgid "Gets the element attribute named *key*."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.etree.elementtree.rst:649
|
|
msgid ""
|
|
"Returns the attribute value, or *default* if the attribute was not found."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.etree.elementtree.rst:654
|
|
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:660
|
|
msgid ""
|
|
"Returns the elements attribute names as a list. The names are returned in "
|
|
"an arbitrary order."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.etree.elementtree.rst:666
|
|
msgid "Set the attribute *key* on the element to *value*."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.etree.elementtree.rst:668
|
|
msgid "The following methods work on the element's children (subelements)."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.etree.elementtree.rst:673
|
|
msgid ""
|
|
"Adds the element *subelement* to the end of this elements internal list of "
|
|
"subelements."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.etree.elementtree.rst:679
|
|
msgid ""
|
|
"Appends *subelements* from a sequence object with zero or more elements. "
|
|
"Raises :exc:`AssertionError` if a subelement is not a valid object."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.etree.elementtree.rst:687
|
|
msgid ""
|
|
"Finds the first subelement matching *match*. *match* may be a tag name or "
|
|
"path. Returns an element instance or ``None``."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.etree.elementtree.rst:693
|
|
msgid ""
|
|
"Finds all matching subelements, by tag name or path. Returns a list "
|
|
"containing all matching elements in document order."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.etree.elementtree.rst:699
|
|
msgid ""
|
|
"Finds text for the first subelement matching *match*. *match* may be a tag "
|
|
"name or path. 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."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.etree.elementtree.rst:707
|
|
msgid "Use ``list(elem)`` or iteration."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.etree.elementtree.rst:713
|
|
msgid "Use method :meth:`Element.iter` instead."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.etree.elementtree.rst:719
|
|
msgid "Inserts a subelement at the given position in this element."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.etree.elementtree.rst:724
|
|
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:735
|
|
msgid ""
|
|
"Finds all matching subelements, by tag name or path. Returns an iterable "
|
|
"yielding all matching elements in document order."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.etree.elementtree.rst:743
|
|
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:751
|
|
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:757
|
|
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:761
|
|
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:766
|
|
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:782
|
|
msgid "ElementTree Objects"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.etree.elementtree.rst:787
|
|
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:791
|
|
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:797
|
|
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:804
|
|
msgid "Same as :meth:`Element.find`, starting at the root of the tree."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.etree.elementtree.rst:809
|
|
msgid "Same as :meth:`Element.findall`, starting at the root of the tree."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.etree.elementtree.rst:814
|
|
msgid "Same as :meth:`Element.findtext`, starting at the root of the tree."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.etree.elementtree.rst:819
|
|
msgid "Use method :meth:`ElementTree.iter` instead."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.etree.elementtree.rst:825
|
|
msgid "Returns the root element for this tree."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.etree.elementtree.rst:830
|
|
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:837
|
|
msgid ""
|
|
"Finds all matching subelements, by tag name or path. Same as getroot()."
|
|
"iterfind(match). Returns an iterable yielding all matching elements in "
|
|
"document order."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.etree.elementtree.rst:846
|
|
msgid ""
|
|
"Loads an external XML section into this element tree. *source* is a file "
|
|
"name or file object. *parser* is an optional parser instance. If not "
|
|
"given, the standard XMLParser parser is used. Returns the section root "
|
|
"element."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.etree.elementtree.rst:855
|
|
msgid ""
|
|
"Writes the element tree to a file, as XML. *file* is a file name, or a 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 (default is ``None``). "
|
|
"*default_namespace* sets the default XML namespace (for \"xmlns\"). "
|
|
"*method* is either ``\"xml\"``, ``\"html\"`` or ``\"text\"`` (default is ``"
|
|
"\"xml\"``). Returns an encoded string."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.etree.elementtree.rst:864
|
|
msgid "This is the XML file that is going to be manipulated::"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.etree.elementtree.rst:876
|
|
msgid ""
|
|
"Example of changing the attribute \"target\" of every link in first "
|
|
"paragraph::"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.etree.elementtree.rst:896
|
|
msgid "QName Objects"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.etree.elementtree.rst:901
|
|
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:912
|
|
msgid "TreeBuilder Objects"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.etree.elementtree.rst:917
|
|
msgid ""
|
|
"Generic element structure builder. This builder converts a sequence of "
|
|
"start, data, and end 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. The *element_factory* is called "
|
|
"to create new :class:`Element` instances when given."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.etree.elementtree.rst:926
|
|
msgid ""
|
|
"Flushes the builder buffers, and returns the toplevel document element. "
|
|
"Returns an :class:`Element` instance."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.etree.elementtree.rst:932
|
|
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:938
|
|
msgid ""
|
|
"Closes the current element. *tag* is the element name. Returns the closed "
|
|
"element."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.etree.elementtree.rst:944
|
|
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:948
|
|
msgid ""
|
|
"In addition, a custom :class:`TreeBuilder` object can provide the following "
|
|
"method:"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.etree.elementtree.rst:953
|
|
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:963
|
|
msgid "XMLParser Objects"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.etree.elementtree.rst:968
|
|
msgid ""
|
|
":class:`Element` structure builder for XML source data, based on the expat "
|
|
"parser. *html* are predefined HTML entities. This flag is not supported by "
|
|
"the current implementation. *target* is the target object. If omitted, the "
|
|
"builder uses an instance of the standard TreeBuilder class. *encoding* [1]_ "
|
|
"is optional. If given, the value overrides the encoding specified in the "
|
|
"XML file."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.etree.elementtree.rst:978
|
|
msgid "Finishes feeding data to the parser. Returns an element structure."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.etree.elementtree.rst:983
|
|
msgid ""
|
|
"Define the :meth:`TreeBuilder.doctype` method on a custom TreeBuilder target."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.etree.elementtree.rst:990
|
|
msgid "Feeds data to the parser. *data* is encoded data."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.etree.elementtree.rst:992
|
|
msgid ""
|
|
":meth:`XMLParser.feed` calls *target*\\'s :meth:`start` method for each "
|
|
"opening tag, its :meth:`end` method for each closing tag, and data is "
|
|
"processed by method :meth:`data`. :meth:`XMLParser.close` calls *target*"
|
|
"\\'s method :meth:`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:1033
|
|
msgid "Footnotes"
|
|
msgstr "Notes"
|
|
|
|
#: ../Doc/library/xml.etree.elementtree.rst:1034
|
|
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 ""
|