forked from AFPy/python-docs-fr
1349 lines
42 KiB
Plaintext
1349 lines
42 KiB
Plaintext
# SOME DESCRIPTIVE TITLE.
|
|
# Copyright (C) 2001-2016, Python Software Foundation
|
|
# This file is distributed under the same license as the Python package.
|
|
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
|
|
#
|
|
#, fuzzy
|
|
msgid ""
|
|
msgstr ""
|
|
"Project-Id-Version: Python 3.6\n"
|
|
"Report-Msgid-Bugs-To: \n"
|
|
"POT-Creation-Date: 2017-04-02 22:11+0200\n"
|
|
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
|
|
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
|
|
"Language-Team: LANGUAGE <LL@li.org>\n"
|
|
"Language: \n"
|
|
"MIME-Version: 1.0\n"
|
|
"Content-Type: text/plain; charset=UTF-8\n"
|
|
"Content-Transfer-Encoding: 8bit\n"
|
|
|
|
#: ../Doc/library/xml.dom.rst:2
|
|
msgid ":mod:`xml.dom` --- The Document Object Model API"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:10
|
|
msgid "**Source code:** :source:`Lib/xml/dom/__init__.py`"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:14
|
|
msgid ""
|
|
"The Document Object Model, or \"DOM,\" is a cross-language API from the "
|
|
"World Wide Web Consortium (W3C) for accessing and modifying XML documents. "
|
|
"A DOM implementation presents an XML document as a tree structure, or allows "
|
|
"client code to build such a structure from scratch. It then gives access to "
|
|
"the structure through a set of objects which provided well-known interfaces."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:20
|
|
msgid ""
|
|
"The DOM is extremely useful for random-access applications. SAX only allows "
|
|
"you a view of one bit of the document at a time. If you are looking at one "
|
|
"SAX element, you have no access to another. If you are looking at a text "
|
|
"node, you have no access to a containing element. When you write a SAX "
|
|
"application, you need to keep track of your program's position in the "
|
|
"document somewhere in your own code. SAX does not do it for you. Also, if "
|
|
"you need to look ahead in the XML document, you are just out of luck."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:28
|
|
msgid ""
|
|
"Some applications are simply impossible in an event driven model with no "
|
|
"access to a tree. Of course you could build some sort of tree yourself in "
|
|
"SAX events, but the DOM allows you to avoid writing that code. The DOM is a "
|
|
"standard tree representation for XML data."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:33
|
|
msgid ""
|
|
"The Document Object Model is being defined by the W3C in stages, or \"levels"
|
|
"\" in their terminology. The Python mapping of the API is substantially "
|
|
"based on the DOM Level 2 recommendation."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:45
|
|
msgid ""
|
|
"DOM applications typically start by parsing some XML into a DOM. How this "
|
|
"is accomplished is not covered at all by DOM Level 1, and Level 2 provides "
|
|
"only limited improvements: There is a :class:`DOMImplementation` object "
|
|
"class which provides access to :class:`Document` creation methods, but no "
|
|
"way to access an XML reader/parser/Document builder in an implementation-"
|
|
"independent way. There is also no well-defined way to access these methods "
|
|
"without an existing :class:`Document` object. In Python, each DOM "
|
|
"implementation will provide a function :func:`getDOMImplementation`. DOM "
|
|
"Level 3 adds a Load/Store specification, which defines an interface to the "
|
|
"reader, but this is not yet available in the Python standard library."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:56
|
|
msgid ""
|
|
"Once you have a DOM document object, you can access the parts of your XML "
|
|
"document through its properties and methods. These properties are defined "
|
|
"in the DOM specification; this portion of the reference manual describes the "
|
|
"interpretation of the specification in Python."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:61
|
|
msgid ""
|
|
"The specification provided by the W3C defines the DOM API for Java, "
|
|
"ECMAScript, and OMG IDL. The Python mapping defined here is based in large "
|
|
"part on the IDL version of the specification, but strict compliance is not "
|
|
"required (though implementations are free to support the strict mapping from "
|
|
"IDL). See section :ref:`dom-conformance` for a detailed discussion of "
|
|
"mapping requirements."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:71
|
|
msgid ""
|
|
"`Document Object Model (DOM) Level 2 Specification <https://www.w3.org/TR/"
|
|
"DOM-Level-2-Core/>`_"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:71
|
|
msgid "The W3C recommendation upon which the Python DOM API is based."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:74
|
|
msgid ""
|
|
"`Document Object Model (DOM) Level 1 Specification <https://www.w3.org/TR/"
|
|
"REC-DOM-Level-1/>`_"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:74
|
|
msgid "The W3C recommendation for the DOM supported by :mod:`xml.dom.minidom`."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:76
|
|
msgid ""
|
|
"`Python Language Mapping Specification <http://www.omg.org/spec/PYTH/1.2/"
|
|
"PDF>`_"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:77
|
|
msgid "This specifies the mapping from OMG IDL to Python."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:81
|
|
msgid "Module Contents"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:83
|
|
msgid "The :mod:`xml.dom` contains the following functions:"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:88
|
|
msgid ""
|
|
"Register the *factory* function with the name *name*. The factory function "
|
|
"should return an object which implements the :class:`DOMImplementation` "
|
|
"interface. The factory function can return the same object every time, or a "
|
|
"new one for each call, as appropriate for the specific implementation (e.g. "
|
|
"if that implementation supports some customization)."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:97
|
|
msgid ""
|
|
"Return a suitable DOM implementation. The *name* is either well-known, the "
|
|
"module name of a DOM implementation, or ``None``. If it is not ``None``, "
|
|
"imports the corresponding module and returns a :class:`DOMImplementation` "
|
|
"object if the import succeeds. If no name is given, and if the environment "
|
|
"variable :envvar:`PYTHON_DOM` is set, this variable is used to find the "
|
|
"implementation."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:103
|
|
msgid ""
|
|
"If name is not given, this examines the available implementations to find "
|
|
"one with the required feature set. If no implementation can be found, raise "
|
|
"an :exc:`ImportError`. The features list must be a sequence of ``(feature, "
|
|
"version)`` pairs which are passed to the :meth:`hasFeature` method on "
|
|
"available :class:`DOMImplementation` objects."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:109
|
|
msgid "Some convenience constants are also provided:"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:114
|
|
msgid ""
|
|
"The value used to indicate that no namespace is associated with a node in "
|
|
"the DOM. This is typically found as the :attr:`namespaceURI` of a node, or "
|
|
"used as the *namespaceURI* parameter to a namespaces-specific method."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:121
|
|
msgid ""
|
|
"The namespace URI associated with the reserved prefix ``xml``, as defined by "
|
|
"`Namespaces in XML <https://www.w3.org/TR/REC-xml-names/>`_ (section 4)."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:127
|
|
msgid ""
|
|
"The namespace URI for namespace declarations, as defined by `Document Object "
|
|
"Model (DOM) Level 2 Core Specification <https://www.w3.org/TR/DOM-Level-2-"
|
|
"Core/core.html>`_ (section 1.1.8)."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:134
|
|
msgid ""
|
|
"The URI of the XHTML namespace as defined by `XHTML 1.0: The Extensible "
|
|
"HyperText Markup Language <https://www.w3.org/TR/xhtml1/>`_ (section 3.1.1)."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:138
|
|
msgid ""
|
|
"In addition, :mod:`xml.dom` contains a base :class:`Node` class and the DOM "
|
|
"exception classes. The :class:`Node` class provided by this module does not "
|
|
"implement any of the methods or attributes defined by the DOM specification; "
|
|
"concrete DOM implementations must provide those. The :class:`Node` class "
|
|
"provided as part of this module does provide the constants used for the :"
|
|
"attr:`nodeType` attribute on concrete :class:`Node` objects; they are "
|
|
"located within the class rather than at the module level to conform with the "
|
|
"DOM specifications."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:153
|
|
msgid "Objects in the DOM"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:155
|
|
msgid ""
|
|
"The definitive documentation for the DOM is the DOM specification from the "
|
|
"W3C."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:157
|
|
msgid ""
|
|
"Note that DOM attributes may also be manipulated as nodes instead of as "
|
|
"simple strings. It is fairly rare that you must do this, however, so this "
|
|
"usage is not yet documented."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:162
|
|
msgid "Interface"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:162
|
|
msgid "Section"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:162
|
|
msgid "Purpose"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:164
|
|
msgid ":class:`DOMImplementation`"
|
|
msgstr ":class:`DOMImplementation`"
|
|
|
|
#: ../Doc/library/xml.dom.rst:164
|
|
msgid ":ref:`dom-implementation-objects`"
|
|
msgstr ":ref:`dom-implementation-objects`"
|
|
|
|
#: ../Doc/library/xml.dom.rst:164
|
|
msgid "Interface to the underlying implementation."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:167
|
|
msgid ":class:`Node`"
|
|
msgstr ":class:`Node`"
|
|
|
|
#: ../Doc/library/xml.dom.rst:167
|
|
msgid ":ref:`dom-node-objects`"
|
|
msgstr ":ref:`dom-node-objects`"
|
|
|
|
#: ../Doc/library/xml.dom.rst:167
|
|
msgid "Base interface for most objects in a document."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:170
|
|
msgid ":class:`NodeList`"
|
|
msgstr ":class:`NodeList`"
|
|
|
|
#: ../Doc/library/xml.dom.rst:170
|
|
msgid ":ref:`dom-nodelist-objects`"
|
|
msgstr ":ref:`dom-nodelist-objects`"
|
|
|
|
#: ../Doc/library/xml.dom.rst:170
|
|
msgid "Interface for a sequence of nodes."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:173
|
|
msgid ":class:`DocumentType`"
|
|
msgstr ":class:`DocumentType`"
|
|
|
|
#: ../Doc/library/xml.dom.rst:173
|
|
msgid ":ref:`dom-documenttype-objects`"
|
|
msgstr ":ref:`dom-documenttype-objects`"
|
|
|
|
#: ../Doc/library/xml.dom.rst:173
|
|
msgid "Information about the declarations needed to process a document."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:177
|
|
msgid ":class:`Document`"
|
|
msgstr ":class:`Document`"
|
|
|
|
#: ../Doc/library/xml.dom.rst:177
|
|
msgid ":ref:`dom-document-objects`"
|
|
msgstr ":ref:`dom-document-objects`"
|
|
|
|
#: ../Doc/library/xml.dom.rst:177
|
|
msgid "Object which represents an entire document."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:180
|
|
msgid ":class:`Element`"
|
|
msgstr ":class:`Element`"
|
|
|
|
#: ../Doc/library/xml.dom.rst:180
|
|
msgid ":ref:`dom-element-objects`"
|
|
msgstr ":ref:`dom-element-objects`"
|
|
|
|
#: ../Doc/library/xml.dom.rst:180
|
|
msgid "Element nodes in the document hierarchy."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:183
|
|
msgid ":class:`Attr`"
|
|
msgstr ":class:`Attr`"
|
|
|
|
#: ../Doc/library/xml.dom.rst:183
|
|
msgid ":ref:`dom-attr-objects`"
|
|
msgstr ":ref:`dom-attr-objects`"
|
|
|
|
#: ../Doc/library/xml.dom.rst:183
|
|
msgid "Attribute value nodes on element nodes."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:186
|
|
msgid ":class:`Comment`"
|
|
msgstr ":class:`Comment`"
|
|
|
|
#: ../Doc/library/xml.dom.rst:186
|
|
msgid ":ref:`dom-comment-objects`"
|
|
msgstr ":ref:`dom-comment-objects`"
|
|
|
|
#: ../Doc/library/xml.dom.rst:186
|
|
msgid "Representation of comments in the source document."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:189
|
|
msgid ":class:`Text`"
|
|
msgstr ":class:`Text`"
|
|
|
|
#: ../Doc/library/xml.dom.rst:189
|
|
msgid ":ref:`dom-text-objects`"
|
|
msgstr ":ref:`dom-text-objects`"
|
|
|
|
#: ../Doc/library/xml.dom.rst:189
|
|
msgid "Nodes containing textual content from the document."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:192
|
|
msgid ":class:`ProcessingInstruction`"
|
|
msgstr ":class:`ProcessingInstruction`"
|
|
|
|
#: ../Doc/library/xml.dom.rst:192
|
|
msgid ":ref:`dom-pi-objects`"
|
|
msgstr ":ref:`dom-pi-objects`"
|
|
|
|
#: ../Doc/library/xml.dom.rst:192
|
|
msgid "Processing instruction representation."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:196
|
|
msgid ""
|
|
"An additional section describes the exceptions defined for working with the "
|
|
"DOM in Python."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:203
|
|
msgid "DOMImplementation Objects"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:205
|
|
msgid ""
|
|
"The :class:`DOMImplementation` interface provides a way for applications to "
|
|
"determine the availability of particular features in the DOM they are using. "
|
|
"DOM Level 2 added the ability to create new :class:`Document` and :class:"
|
|
"`DocumentType` objects using the :class:`DOMImplementation` as well."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:213
|
|
msgid ""
|
|
"Return true if the feature identified by the pair of strings *feature* and "
|
|
"*version* is implemented."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:219
|
|
msgid ""
|
|
"Return a new :class:`Document` object (the root of the DOM), with a child :"
|
|
"class:`Element` object having the given *namespaceUri* and *qualifiedName*. "
|
|
"The *doctype* must be a :class:`DocumentType` object created by :meth:"
|
|
"`createDocumentType`, or ``None``. In the Python DOM API, the first two "
|
|
"arguments can also be ``None`` in order to indicate that no :class:`Element` "
|
|
"child is to be created."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:229
|
|
msgid ""
|
|
"Return a new :class:`DocumentType` object that encapsulates the given "
|
|
"*qualifiedName*, *publicId*, and *systemId* strings, representing the "
|
|
"information contained in an XML document type declaration."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:237
|
|
msgid "Node Objects"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:239
|
|
msgid ""
|
|
"All of the components of an XML document are subclasses of :class:`Node`."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:244
|
|
msgid ""
|
|
"An integer representing the node type. Symbolic constants for the types are "
|
|
"on the :class:`Node` object: :const:`ELEMENT_NODE`, :const:"
|
|
"`ATTRIBUTE_NODE`, :const:`TEXT_NODE`, :const:`CDATA_SECTION_NODE`, :const:"
|
|
"`ENTITY_NODE`, :const:`PROCESSING_INSTRUCTION_NODE`, :const:`COMMENT_NODE`, :"
|
|
"const:`DOCUMENT_NODE`, :const:`DOCUMENT_TYPE_NODE`, :const:`NOTATION_NODE`. "
|
|
"This is a read-only attribute."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:254
|
|
msgid ""
|
|
"The parent of the current node, or ``None`` for the document node. The value "
|
|
"is always a :class:`Node` object or ``None``. For :class:`Element` nodes, "
|
|
"this will be the parent element, except for the root element, in which case "
|
|
"it will be the :class:`Document` object. For :class:`Attr` nodes, this is "
|
|
"always ``None``. This is a read-only attribute."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:263
|
|
msgid ""
|
|
"A :class:`NamedNodeMap` of attribute objects. Only elements have actual "
|
|
"values for this; others provide ``None`` for this attribute. This is a read-"
|
|
"only attribute."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:270
|
|
msgid ""
|
|
"The node that immediately precedes this one with the same parent. For "
|
|
"instance the element with an end-tag that comes just before the *self* "
|
|
"element's start-tag. Of course, XML documents are made up of more than just "
|
|
"elements so the previous sibling could be text, a comment, or something "
|
|
"else. If this node is the first child of the parent, this attribute will be "
|
|
"``None``. This is a read-only attribute."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:280
|
|
msgid ""
|
|
"The node that immediately follows this one with the same parent. See also :"
|
|
"attr:`previousSibling`. If this is the last child of the parent, this "
|
|
"attribute will be ``None``. This is a read-only attribute."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:287
|
|
msgid ""
|
|
"A list of nodes contained within this node. This is a read-only attribute."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:292
|
|
msgid ""
|
|
"The first child of the node, if there are any, or ``None``. This is a read-"
|
|
"only attribute."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:298
|
|
msgid ""
|
|
"The last child of the node, if there are any, or ``None``. This is a read-"
|
|
"only attribute."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:304
|
|
msgid ""
|
|
"The part of the :attr:`tagName` following the colon if there is one, else "
|
|
"the entire :attr:`tagName`. The value is a string."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:310
|
|
msgid ""
|
|
"The part of the :attr:`tagName` preceding the colon if there is one, else "
|
|
"the empty string. The value is a string, or ``None``."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:316
|
|
msgid ""
|
|
"The namespace associated with the element name. This will be a string or "
|
|
"``None``. This is a read-only attribute."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:322
|
|
msgid ""
|
|
"This has a different meaning for each node type; see the DOM specification "
|
|
"for details. You can always get the information you would get here from "
|
|
"another property such as the :attr:`tagName` property for elements or the :"
|
|
"attr:`name` property for attributes. For all node types, the value of this "
|
|
"attribute will be either a string or ``None``. This is a read-only "
|
|
"attribute."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:331
|
|
msgid ""
|
|
"This has a different meaning for each node type; see the DOM specification "
|
|
"for details. The situation is similar to that with :attr:`nodeName`. The "
|
|
"value is a string or ``None``."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:338
|
|
msgid "Returns true if the node has any attributes."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:343
|
|
msgid "Returns true if the node has any child nodes."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:348
|
|
msgid ""
|
|
"Returns true if *other* refers to the same node as this node. This is "
|
|
"especially useful for DOM implementations which use any sort of proxy "
|
|
"architecture (because more than one object can refer to the same node)."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:354
|
|
msgid ""
|
|
"This is based on a proposed DOM Level 3 API which is still in the \"working "
|
|
"draft\" stage, but this particular interface appears uncontroversial. "
|
|
"Changes from the W3C will not necessarily affect this method in the Python "
|
|
"DOM interface (though any new W3C API for this would also be supported)."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:362
|
|
msgid ""
|
|
"Add a new child node to this node at the end of the list of children, "
|
|
"returning *newChild*. If the node was already in the tree, it is removed "
|
|
"first."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:369
|
|
msgid ""
|
|
"Insert a new child node before an existing child. It must be the case that "
|
|
"*refChild* is a child of this node; if not, :exc:`ValueError` is raised. "
|
|
"*newChild* is returned. If *refChild* is ``None``, it inserts *newChild* at "
|
|
"the end of the children's list."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:377
|
|
msgid ""
|
|
"Remove a child node. *oldChild* must be a child of this node; if not, :exc:"
|
|
"`ValueError` is raised. *oldChild* is returned on success. If *oldChild* "
|
|
"will not be used further, its :meth:`unlink` method should be called."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:384
|
|
msgid ""
|
|
"Replace an existing node with a new node. It must be the case that "
|
|
"*oldChild* is a child of this node; if not, :exc:`ValueError` is raised."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:390
|
|
msgid ""
|
|
"Join adjacent text nodes so that all stretches of text are stored as single :"
|
|
"class:`Text` instances. This simplifies processing text from a DOM tree for "
|
|
"many applications."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:397
|
|
msgid ""
|
|
"Clone this node. Setting *deep* means to clone all child nodes as well. "
|
|
"This returns the clone."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:404
|
|
msgid "NodeList Objects"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:406
|
|
msgid ""
|
|
"A :class:`NodeList` represents a sequence of nodes. These objects are used "
|
|
"in two ways in the DOM Core recommendation: an :class:`Element` object "
|
|
"provides one as its list of child nodes, and the :meth:"
|
|
"`getElementsByTagName` and :meth:`getElementsByTagNameNS` methods of :class:"
|
|
"`Node` return objects with this interface to represent query results."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:412
|
|
msgid ""
|
|
"The DOM Level 2 recommendation defines one method and one attribute for "
|
|
"these objects:"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:418
|
|
msgid ""
|
|
"Return the *i*'th item from the sequence, if there is one, or ``None``. The "
|
|
"index *i* is not allowed to be less than zero or greater than or equal to "
|
|
"the length of the sequence."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:425
|
|
msgid "The number of nodes in the sequence."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:427
|
|
msgid ""
|
|
"In addition, the Python DOM interface requires that some additional support "
|
|
"is provided to allow :class:`NodeList` objects to be used as Python "
|
|
"sequences. All :class:`NodeList` implementations must include support for :"
|
|
"meth:`~object.__len__` and :meth:`~object.__getitem__`; this allows "
|
|
"iteration over the :class:`NodeList` in :keyword:`for` statements and proper "
|
|
"support for the :func:`len` built-in function."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:435
|
|
msgid ""
|
|
"If a DOM implementation supports modification of the document, the :class:"
|
|
"`NodeList` implementation must also support the :meth:`~object.__setitem__` "
|
|
"and :meth:`~object.__delitem__` methods."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:443
|
|
msgid "DocumentType Objects"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:445
|
|
msgid ""
|
|
"Information about the notations and entities declared by a document "
|
|
"(including the external subset if the parser uses it and can provide the "
|
|
"information) is available from a :class:`DocumentType` object. The :class:"
|
|
"`DocumentType` for a document is available from the :class:`Document` "
|
|
"object's :attr:`doctype` attribute; if there is no ``DOCTYPE`` declaration "
|
|
"for the document, the document's :attr:`doctype` attribute will be set to "
|
|
"``None`` instead of an instance of this interface."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:453
|
|
msgid ""
|
|
":class:`DocumentType` is a specialization of :class:`Node`, and adds the "
|
|
"following attributes:"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:459
|
|
msgid ""
|
|
"The public identifier for the external subset of the document type "
|
|
"definition. This will be a string or ``None``."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:465
|
|
msgid ""
|
|
"The system identifier for the external subset of the document type "
|
|
"definition. This will be a URI as a string, or ``None``."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:471
|
|
msgid ""
|
|
"A string giving the complete internal subset from the document. This does "
|
|
"not include the brackets which enclose the subset. If the document has no "
|
|
"internal subset, this should be ``None``."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:478
|
|
msgid ""
|
|
"The name of the root element as given in the ``DOCTYPE`` declaration, if "
|
|
"present."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:484
|
|
msgid ""
|
|
"This is a :class:`NamedNodeMap` giving the definitions of external entities. "
|
|
"For entity names defined more than once, only the first definition is "
|
|
"provided (others are ignored as required by the XML recommendation). This "
|
|
"may be ``None`` if the information is not provided by the parser, or if no "
|
|
"entities are defined."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:493
|
|
msgid ""
|
|
"This is a :class:`NamedNodeMap` giving the definitions of notations. For "
|
|
"notation names defined more than once, only the first definition is provided "
|
|
"(others are ignored as required by the XML recommendation). This may be "
|
|
"``None`` if the information is not provided by the parser, or if no "
|
|
"notations are defined."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:503
|
|
msgid "Document Objects"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:505
|
|
msgid ""
|
|
"A :class:`Document` represents an entire XML document, including its "
|
|
"constituent elements, attributes, processing instructions, comments etc. "
|
|
"Remember that it inherits properties from :class:`Node`."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:512
|
|
msgid "The one and only root element of the document."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:517
|
|
msgid ""
|
|
"Create and return a new element node. The element is not inserted into the "
|
|
"document when it is created. You need to explicitly insert it with one of "
|
|
"the other methods such as :meth:`insertBefore` or :meth:`appendChild`."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:524
|
|
msgid ""
|
|
"Create and return a new element with a namespace. The *tagName* may have a "
|
|
"prefix. The element is not inserted into the document when it is created. "
|
|
"You need to explicitly insert it with one of the other methods such as :meth:"
|
|
"`insertBefore` or :meth:`appendChild`."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:532
|
|
msgid ""
|
|
"Create and return a text node containing the data passed as a parameter. As "
|
|
"with the other creation methods, this one does not insert the node into the "
|
|
"tree."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:539
|
|
msgid ""
|
|
"Create and return a comment node containing the data passed as a parameter. "
|
|
"As with the other creation methods, this one does not insert the node into "
|
|
"the tree."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:546
|
|
msgid ""
|
|
"Create and return a processing instruction node containing the *target* and "
|
|
"*data* passed as parameters. As with the other creation methods, this one "
|
|
"does not insert the node into the tree."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:553
|
|
msgid ""
|
|
"Create and return an attribute node. This method does not associate the "
|
|
"attribute node with any particular element. You must use :meth:"
|
|
"`setAttributeNode` on the appropriate :class:`Element` object to use the "
|
|
"newly created attribute instance."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:561
|
|
msgid ""
|
|
"Create and return an attribute node with a namespace. The *tagName* may "
|
|
"have a prefix. This method does not associate the attribute node with any "
|
|
"particular element. You must use :meth:`setAttributeNode` on the "
|
|
"appropriate :class:`Element` object to use the newly created attribute "
|
|
"instance."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:569
|
|
msgid ""
|
|
"Search for all descendants (direct children, children's children, etc.) with "
|
|
"a particular element type name."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:575
|
|
msgid ""
|
|
"Search for all descendants (direct children, children's children, etc.) with "
|
|
"a particular namespace URI and localname. The localname is the part of the "
|
|
"namespace after the prefix."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:583
|
|
msgid "Element Objects"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:585
|
|
msgid ""
|
|
":class:`Element` is a subclass of :class:`Node`, so inherits all the "
|
|
"attributes of that class."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:591
|
|
msgid ""
|
|
"The element type name. In a namespace-using document it may have colons in "
|
|
"it. The value is a string."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:597 ../Doc/library/xml.dom.rst:602
|
|
msgid "Same as equivalent method in the :class:`Document` class."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:607
|
|
msgid "Returns true if the element has an attribute named by *name*."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:612
|
|
msgid ""
|
|
"Returns true if the element has an attribute named by *namespaceURI* and "
|
|
"*localName*."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:618
|
|
msgid ""
|
|
"Return the value of the attribute named by *name* as a string. If no such "
|
|
"attribute exists, an empty string is returned, as if the attribute had no "
|
|
"value."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:624
|
|
msgid "Return the :class:`Attr` node for the attribute named by *attrname*."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:629
|
|
msgid ""
|
|
"Return the value of the attribute named by *namespaceURI* and *localName* as "
|
|
"a string. If no such attribute exists, an empty string is returned, as if "
|
|
"the attribute had no value."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:636
|
|
msgid ""
|
|
"Return an attribute value as a node, given a *namespaceURI* and *localName*."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:641
|
|
msgid ""
|
|
"Remove an attribute by name. If there is no matching attribute, a :exc:"
|
|
"`NotFoundErr` is raised."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:647
|
|
msgid ""
|
|
"Remove and return *oldAttr* from the attribute list, if present. If "
|
|
"*oldAttr* is not present, :exc:`NotFoundErr` is raised."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:653
|
|
msgid ""
|
|
"Remove an attribute by name. Note that it uses a localName, not a qname. "
|
|
"No exception is raised if there is no matching attribute."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:659
|
|
msgid "Set an attribute value from a string."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:664
|
|
msgid ""
|
|
"Add a new attribute node to the element, replacing an existing attribute if "
|
|
"necessary if the :attr:`name` attribute matches. If a replacement occurs, "
|
|
"the old attribute node will be returned. If *newAttr* is already in use, :"
|
|
"exc:`InuseAttributeErr` will be raised."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:672
|
|
msgid ""
|
|
"Add a new attribute node to the element, replacing an existing attribute if "
|
|
"necessary if the :attr:`namespaceURI` and :attr:`localName` attributes "
|
|
"match. If a replacement occurs, the old attribute node will be returned. If "
|
|
"*newAttr* is already in use, :exc:`InuseAttributeErr` will be raised."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:680
|
|
msgid ""
|
|
"Set an attribute value from a string, given a *namespaceURI* and a *qname*. "
|
|
"Note that a qname is the whole attribute name. This is different than above."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:687
|
|
msgid "Attr Objects"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:689
|
|
msgid ""
|
|
":class:`Attr` inherits from :class:`Node`, so inherits all its attributes."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:694
|
|
msgid ""
|
|
"The attribute name. In a namespace-using document it may include a colon."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:700
|
|
msgid ""
|
|
"The part of the name following the colon if there is one, else the entire "
|
|
"name. This is a read-only attribute."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:707
|
|
msgid ""
|
|
"The part of the name preceding the colon if there is one, else the empty "
|
|
"string."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:713
|
|
msgid ""
|
|
"The text value of the attribute. This is a synonym for the :attr:"
|
|
"`nodeValue` attribute."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:720
|
|
msgid "NamedNodeMap Objects"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:722
|
|
msgid ":class:`NamedNodeMap` does *not* inherit from :class:`Node`."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:727
|
|
msgid "The length of the attribute list."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:732
|
|
msgid ""
|
|
"Return an attribute with a particular index. The order you get the "
|
|
"attributes in is arbitrary but will be consistent for the life of a DOM. "
|
|
"Each item is an attribute node. Get its value with the :attr:`value` "
|
|
"attribute."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:736
|
|
msgid ""
|
|
"There are also experimental methods that give this class more mapping "
|
|
"behavior. You can use them or you can use the standardized :meth:"
|
|
"`getAttribute\\*` family of methods on the :class:`Element` objects."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:744
|
|
msgid "Comment Objects"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:746
|
|
msgid ""
|
|
":class:`Comment` represents a comment in the XML document. It is a subclass "
|
|
"of :class:`Node`, but cannot have child nodes."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:752
|
|
msgid ""
|
|
"The content of the comment as a string. The attribute contains all "
|
|
"characters between the leading ``<!-``\\ ``-`` and trailing ``-``\\ ``->``, "
|
|
"but does not include them."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:760
|
|
msgid "Text and CDATASection Objects"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:762
|
|
msgid ""
|
|
"The :class:`Text` interface represents text in the XML document. If the "
|
|
"parser and DOM implementation support the DOM's XML extension, portions of "
|
|
"the text enclosed in CDATA marked sections are stored in :class:"
|
|
"`CDATASection` objects. These two interfaces are identical, but provide "
|
|
"different values for the :attr:`nodeType` attribute."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:768
|
|
msgid ""
|
|
"These interfaces extend the :class:`Node` interface. They cannot have child "
|
|
"nodes."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:774
|
|
msgid "The content of the text node as a string."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:778
|
|
msgid ""
|
|
"The use of a :class:`CDATASection` node does not indicate that the node "
|
|
"represents a complete CDATA marked section, only that the content of the "
|
|
"node was part of a CDATA section. A single CDATA section may be represented "
|
|
"by more than one node in the document tree. There is no way to determine "
|
|
"whether two adjacent :class:`CDATASection` nodes represent different CDATA "
|
|
"marked sections."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:788
|
|
msgid "ProcessingInstruction Objects"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:790
|
|
msgid ""
|
|
"Represents a processing instruction in the XML document; this inherits from "
|
|
"the :class:`Node` interface and cannot have child nodes."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:796
|
|
msgid ""
|
|
"The content of the processing instruction up to the first whitespace "
|
|
"character. This is a read-only attribute."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:802
|
|
msgid ""
|
|
"The content of the processing instruction following the first whitespace "
|
|
"character."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:809
|
|
msgid "Exceptions"
|
|
msgstr "Les exceptions"
|
|
|
|
#: ../Doc/library/xml.dom.rst:811
|
|
msgid ""
|
|
"The DOM Level 2 recommendation defines a single exception, :exc:"
|
|
"`DOMException`, and a number of constants that allow applications to "
|
|
"determine what sort of error occurred. :exc:`DOMException` instances carry "
|
|
"a :attr:`code` attribute that provides the appropriate value for the "
|
|
"specific exception."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:816
|
|
msgid ""
|
|
"The Python DOM interface provides the constants, but also expands the set of "
|
|
"exceptions so that a specific exception exists for each of the exception "
|
|
"codes defined by the DOM. The implementations must raise the appropriate "
|
|
"specific exception, each of which carries the appropriate value for the :"
|
|
"attr:`code` attribute."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:825
|
|
msgid ""
|
|
"Base exception class used for all specific DOM exceptions. This exception "
|
|
"class cannot be directly instantiated."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:831
|
|
msgid ""
|
|
"Raised when a specified range of text does not fit into a string. This is "
|
|
"not known to be used in the Python DOM implementations, but may be received "
|
|
"from DOM implementations not written in Python."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:838
|
|
msgid ""
|
|
"Raised when an attempt is made to insert a node where the node type is not "
|
|
"allowed."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:844
|
|
msgid ""
|
|
"Raised when an index or size parameter to a method is negative or exceeds "
|
|
"the allowed values."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:850
|
|
msgid ""
|
|
"Raised when an attempt is made to insert an :class:`Attr` node that is "
|
|
"already present elsewhere in the document."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:856
|
|
msgid ""
|
|
"Raised if a parameter or an operation is not supported on the underlying "
|
|
"object."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:861
|
|
msgid ""
|
|
"This exception is raised when a string parameter contains a character that "
|
|
"is not permitted in the context it's being used in by the XML 1.0 "
|
|
"recommendation. For example, attempting to create an :class:`Element` node "
|
|
"with a space in the element type name will cause this error to be raised."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:869
|
|
msgid "Raised when an attempt is made to modify the type of a node."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:874
|
|
msgid ""
|
|
"Raised when an attempt is made to use an object that is not defined or is no "
|
|
"longer usable."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:880
|
|
msgid ""
|
|
"If an attempt is made to change any object in a way that is not permitted "
|
|
"with regard to the `Namespaces in XML <https://www.w3.org/TR/REC-xml-names/"
|
|
">`_ recommendation, this exception is raised."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:887
|
|
msgid ""
|
|
"Exception when a node does not exist in the referenced context. For "
|
|
"example, :meth:`NamedNodeMap.removeNamedItem` will raise this if the node "
|
|
"passed in does not exist in the map."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:894
|
|
msgid ""
|
|
"Raised when the implementation does not support the requested type of object "
|
|
"or operation."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:900
|
|
msgid ""
|
|
"This is raised if data is specified for a node which does not support data."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:907
|
|
msgid ""
|
|
"Raised on attempts to modify an object where modifications are not allowed "
|
|
"(such as for read-only nodes)."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:913
|
|
msgid "Raised when an invalid or illegal string is specified."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:920
|
|
msgid ""
|
|
"Raised when a node is inserted in a different document than it currently "
|
|
"belongs to, and the implementation does not support migrating the node from "
|
|
"one document to the other."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:924
|
|
msgid ""
|
|
"The exception codes defined in the DOM recommendation map to the exceptions "
|
|
"described above according to this table:"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:928
|
|
msgid "Constant"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:928
|
|
msgid "Exception"
|
|
msgstr "Exception"
|
|
|
|
#: ../Doc/library/xml.dom.rst:930
|
|
msgid ":const:`DOMSTRING_SIZE_ERR`"
|
|
msgstr ":const:`DOMSTRING_SIZE_ERR`"
|
|
|
|
#: ../Doc/library/xml.dom.rst:930
|
|
msgid ":exc:`DomstringSizeErr`"
|
|
msgstr ":exc:`DomstringSizeErr`"
|
|
|
|
#: ../Doc/library/xml.dom.rst:932
|
|
msgid ":const:`HIERARCHY_REQUEST_ERR`"
|
|
msgstr ":const:`HIERARCHY_REQUEST_ERR`"
|
|
|
|
#: ../Doc/library/xml.dom.rst:932
|
|
msgid ":exc:`HierarchyRequestErr`"
|
|
msgstr ":exc:`HierarchyRequestErr`"
|
|
|
|
#: ../Doc/library/xml.dom.rst:934
|
|
msgid ":const:`INDEX_SIZE_ERR`"
|
|
msgstr ":const:`INDEX_SIZE_ERR`"
|
|
|
|
#: ../Doc/library/xml.dom.rst:934
|
|
msgid ":exc:`IndexSizeErr`"
|
|
msgstr ":exc:`IndexSizeErr`"
|
|
|
|
#: ../Doc/library/xml.dom.rst:936
|
|
msgid ":const:`INUSE_ATTRIBUTE_ERR`"
|
|
msgstr ":const:`INUSE_ATTRIBUTE_ERR`"
|
|
|
|
#: ../Doc/library/xml.dom.rst:936
|
|
msgid ":exc:`InuseAttributeErr`"
|
|
msgstr ":exc:`InuseAttributeErr`"
|
|
|
|
#: ../Doc/library/xml.dom.rst:938
|
|
msgid ":const:`INVALID_ACCESS_ERR`"
|
|
msgstr ":const:`INVALID_ACCESS_ERR`"
|
|
|
|
#: ../Doc/library/xml.dom.rst:938
|
|
msgid ":exc:`InvalidAccessErr`"
|
|
msgstr ":exc:`InvalidAccessErr`"
|
|
|
|
#: ../Doc/library/xml.dom.rst:940
|
|
msgid ":const:`INVALID_CHARACTER_ERR`"
|
|
msgstr ":const:`INVALID_CHARACTER_ERR`"
|
|
|
|
#: ../Doc/library/xml.dom.rst:940
|
|
msgid ":exc:`InvalidCharacterErr`"
|
|
msgstr ":exc:`InvalidCharacterErr`"
|
|
|
|
#: ../Doc/library/xml.dom.rst:942
|
|
msgid ":const:`INVALID_MODIFICATION_ERR`"
|
|
msgstr ":const:`INVALID_MODIFICATION_ERR`"
|
|
|
|
#: ../Doc/library/xml.dom.rst:942
|
|
msgid ":exc:`InvalidModificationErr`"
|
|
msgstr ":exc:`InvalidModificationErr`"
|
|
|
|
#: ../Doc/library/xml.dom.rst:944
|
|
msgid ":const:`INVALID_STATE_ERR`"
|
|
msgstr ":const:`INVALID_STATE_ERR`"
|
|
|
|
#: ../Doc/library/xml.dom.rst:944
|
|
msgid ":exc:`InvalidStateErr`"
|
|
msgstr ":exc:`InvalidStateErr`"
|
|
|
|
#: ../Doc/library/xml.dom.rst:946
|
|
msgid ":const:`NAMESPACE_ERR`"
|
|
msgstr ":const:`NAMESPACE_ERR`"
|
|
|
|
#: ../Doc/library/xml.dom.rst:946
|
|
msgid ":exc:`NamespaceErr`"
|
|
msgstr ":exc:`NamespaceErr`"
|
|
|
|
#: ../Doc/library/xml.dom.rst:948
|
|
msgid ":const:`NOT_FOUND_ERR`"
|
|
msgstr ":const:`NOT_FOUND_ERR`"
|
|
|
|
#: ../Doc/library/xml.dom.rst:948
|
|
msgid ":exc:`NotFoundErr`"
|
|
msgstr ":exc:`NotFoundErr`"
|
|
|
|
#: ../Doc/library/xml.dom.rst:950
|
|
msgid ":const:`NOT_SUPPORTED_ERR`"
|
|
msgstr ":const:`NOT_SUPPORTED_ERR`"
|
|
|
|
#: ../Doc/library/xml.dom.rst:950
|
|
msgid ":exc:`NotSupportedErr`"
|
|
msgstr ":exc:`NotSupportedErr`"
|
|
|
|
#: ../Doc/library/xml.dom.rst:952
|
|
msgid ":const:`NO_DATA_ALLOWED_ERR`"
|
|
msgstr ":const:`NO_DATA_ALLOWED_ERR`"
|
|
|
|
#: ../Doc/library/xml.dom.rst:952
|
|
msgid ":exc:`NoDataAllowedErr`"
|
|
msgstr ":exc:`NoDataAllowedErr`"
|
|
|
|
#: ../Doc/library/xml.dom.rst:954
|
|
msgid ":const:`NO_MODIFICATION_ALLOWED_ERR`"
|
|
msgstr ":const:`NO_MODIFICATION_ALLOWED_ERR`"
|
|
|
|
#: ../Doc/library/xml.dom.rst:954
|
|
msgid ":exc:`NoModificationAllowedErr`"
|
|
msgstr ":exc:`NoModificationAllowedErr`"
|
|
|
|
#: ../Doc/library/xml.dom.rst:956
|
|
msgid ":const:`SYNTAX_ERR`"
|
|
msgstr ":const:`SYNTAX_ERR`"
|
|
|
|
#: ../Doc/library/xml.dom.rst:956
|
|
msgid ":exc:`SyntaxErr`"
|
|
msgstr ":exc:`SyntaxErr`"
|
|
|
|
#: ../Doc/library/xml.dom.rst:958
|
|
msgid ":const:`WRONG_DOCUMENT_ERR`"
|
|
msgstr ":const:`WRONG_DOCUMENT_ERR`"
|
|
|
|
#: ../Doc/library/xml.dom.rst:958
|
|
msgid ":exc:`WrongDocumentErr`"
|
|
msgstr ":exc:`WrongDocumentErr`"
|
|
|
|
#: ../Doc/library/xml.dom.rst:965
|
|
msgid "Conformance"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:967
|
|
msgid ""
|
|
"This section describes the conformance requirements and relationships "
|
|
"between the Python DOM API, the W3C DOM recommendations, and the OMG IDL "
|
|
"mapping for Python."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:975
|
|
msgid "Type Mapping"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:977
|
|
msgid ""
|
|
"The IDL types used in the DOM specification are mapped to Python types "
|
|
"according to the following table."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:981
|
|
msgid "IDL Type"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:981
|
|
msgid "Python Type"
|
|
msgstr "Type Python"
|
|
|
|
#: ../Doc/library/xml.dom.rst:983
|
|
msgid "``boolean``"
|
|
msgstr "``boolean``"
|
|
|
|
#: ../Doc/library/xml.dom.rst:983
|
|
msgid "``bool`` or ``int``"
|
|
msgstr "``bool`` or ``int``"
|
|
|
|
#: ../Doc/library/xml.dom.rst:985 ../Doc/library/xml.dom.rst:987
|
|
#: ../Doc/library/xml.dom.rst:989
|
|
msgid "``int``"
|
|
msgstr "``int``"
|
|
|
|
#: ../Doc/library/xml.dom.rst:987
|
|
msgid "``long int``"
|
|
msgstr "``long int``"
|
|
|
|
#: ../Doc/library/xml.dom.rst:989
|
|
msgid "``unsigned int``"
|
|
msgstr "``unsigned int``"
|
|
|
|
#: ../Doc/library/xml.dom.rst:991
|
|
msgid "``DOMString``"
|
|
msgstr "``DOMString``"
|
|
|
|
#: ../Doc/library/xml.dom.rst:991
|
|
msgid "``str`` or ``bytes``"
|
|
msgstr "``str`` or ``bytes``"
|
|
|
|
#: ../Doc/library/xml.dom.rst:993
|
|
msgid "``null``"
|
|
msgstr "``null``"
|
|
|
|
#: ../Doc/library/xml.dom.rst:993
|
|
msgid "``None``"
|
|
msgstr "``None``"
|
|
|
|
#: ../Doc/library/xml.dom.rst:999
|
|
msgid "Accessor Methods"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:1001
|
|
msgid ""
|
|
"The mapping from OMG IDL to Python defines accessor functions for IDL "
|
|
"``attribute`` declarations in much the way the Java mapping does. Mapping "
|
|
"the IDL declarations ::"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:1008
|
|
msgid ""
|
|
"yields three accessor functions: a \"get\" method for :attr:`someValue` (:"
|
|
"meth:`_get_someValue`), and \"get\" and \"set\" methods for :attr:"
|
|
"`anotherValue` (:meth:`_get_anotherValue` and :meth:`_set_anotherValue`). "
|
|
"The mapping, in particular, does not require that the IDL attributes are "
|
|
"accessible as normal Python attributes: ``object.someValue`` is *not* "
|
|
"required to work, and may raise an :exc:`AttributeError`."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:1015
|
|
msgid ""
|
|
"The Python DOM API, however, *does* require that normal attribute access "
|
|
"work. This means that the typical surrogates generated by Python IDL "
|
|
"compilers are not likely to work, and wrapper objects may be needed on the "
|
|
"client if the DOM objects are accessed via CORBA. While this does require "
|
|
"some additional consideration for CORBA DOM clients, the implementers with "
|
|
"experience using DOM over CORBA from Python do not consider this a problem. "
|
|
"Attributes that are declared ``readonly`` may not restrict write access in "
|
|
"all DOM implementations."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:1024
|
|
msgid ""
|
|
"In the Python DOM API, accessor functions are not required. If provided, "
|
|
"they should take the form defined by the Python IDL mapping, but these "
|
|
"methods are considered unnecessary since the attributes are accessible "
|
|
"directly from Python. \"Set\" accessors should never be provided for "
|
|
"``readonly`` attributes."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/xml.dom.rst:1029
|
|
msgid ""
|
|
"The IDL definitions do not fully embody the requirements of the W3C DOM API, "
|
|
"such as the notion of certain objects, such as the return value of :meth:"
|
|
"`getElementsByTagName`, being \"live\". The Python DOM API does not require "
|
|
"implementations to enforce such requirements."
|
|
msgstr ""
|