xml.dom.po

# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2001-2022, Python Software Foundation
# This file is distributed under the same license as the Python package.
#
# Translators:
msgid ""
msgstr ""
"Project-Id-Version: Python 3.13\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2024-09-03 11:11+0800\n"
"PO-Revision-Date: 2018-05-23 16:16+0000\n"
"Last-Translator: Adrian Liaw <adrianliaw2000@gmail.com>\n"
"Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
"tw)\n"
"Language: zh_TW\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Plural-Forms: nplurals=1; plural=0;\n"

#: ../../library/xml.dom.rst:2
msgid ":mod:`!xml.dom` --- The Document Object Model API"
msgstr ":mod:`!xml.dom` --- Document 物件模型 API"

#: ../../library/xml.dom.rst:10
msgid "**Source code:** :source:`Lib/xml/dom/__init__.py`"
msgstr "**原始碼：**\\ :source:`Lib/xml/dom/__init__.py`"

#: ../../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 ""

#: ../../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 ""

#: ../../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 ""

#: ../../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 ""

#: ../../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 ""

#: ../../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 ""

#: ../../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 ""

#: ../../library/xml.dom.rst:70
msgid ""
"`Document Object Model (DOM) Level 2 Specification <https://www.w3.org/"
"TR/2000/REC-DOM-Level-2-Core-20001113/>`_"
msgstr ""

#: ../../library/xml.dom.rst:71
msgid "The W3C recommendation upon which the Python DOM API is based."
msgstr ""

#: ../../library/xml.dom.rst:73
msgid ""
"`Document Object Model (DOM) Level 1 Specification <https://www.w3.org/TR/"
"REC-DOM-Level-1/>`_"
msgstr ""

#: ../../library/xml.dom.rst:74
msgid "The W3C recommendation for the DOM supported by :mod:`xml.dom.minidom`."
msgstr ""

#: ../../library/xml.dom.rst:76
msgid ""
"`Python Language Mapping Specification <https://www.omg.org/spec/PYTH/1.2/"
"PDF>`_"
msgstr ""

#: ../../library/xml.dom.rst:77
msgid "This specifies the mapping from OMG IDL to Python."
msgstr ""

#: ../../library/xml.dom.rst:81
msgid "Module Contents"
msgstr "模組內容"

#: ../../library/xml.dom.rst:83
msgid "The :mod:`xml.dom` contains the following functions:"
msgstr ""

#: ../../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 ""

#: ../../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 ""

#: ../../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 ""

#: ../../library/xml.dom.rst:109
msgid "Some convenience constants are also provided:"
msgstr ""

#: ../../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 ""

#: ../../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 ""

#: ../../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 ""

#: ../../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 ""

#: ../../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 ""

#: ../../library/xml.dom.rst:153
msgid "Objects in the DOM"
msgstr ""

#: ../../library/xml.dom.rst:155
msgid ""
"The definitive documentation for the DOM is the DOM specification from the "
"W3C."
msgstr ""

#: ../../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 ""

#: ../../library/xml.dom.rst:162
msgid "Interface"
msgstr ""

#: ../../library/xml.dom.rst:162
msgid "Section"
msgstr ""

#: ../../library/xml.dom.rst:162
msgid "Purpose"
msgstr ""

#: ../../library/xml.dom.rst:164
msgid ":class:`DOMImplementation`"
msgstr ":class:`DOMImplementation`"

#: ../../library/xml.dom.rst:164
msgid ":ref:`dom-implementation-objects`"
msgstr ":ref:`dom-implementation-objects`"

#: ../../library/xml.dom.rst:164
msgid "Interface to the underlying implementation."
msgstr ""

#: ../../library/xml.dom.rst:167
msgid ":class:`Node`"
msgstr ":class:`Node`"

#: ../../library/xml.dom.rst:167
msgid ":ref:`dom-node-objects`"
msgstr ":ref:`dom-node-objects`"

#: ../../library/xml.dom.rst:167
msgid "Base interface for most objects in a document."
msgstr ""

#: ../../library/xml.dom.rst:170
msgid ":class:`NodeList`"
msgstr ":class:`NodeList`"

#: ../../library/xml.dom.rst:170
msgid ":ref:`dom-nodelist-objects`"
msgstr ":ref:`dom-nodelist-objects`"

#: ../../library/xml.dom.rst:170
msgid "Interface for a sequence of nodes."
msgstr ""

#: ../../library/xml.dom.rst:173
msgid ":class:`DocumentType`"
msgstr ":class:`DocumentType`"

#: ../../library/xml.dom.rst:173
msgid ":ref:`dom-documenttype-objects`"
msgstr ":ref:`dom-documenttype-objects`"

#: ../../library/xml.dom.rst:173
msgid "Information about the declarations needed to process a document."
msgstr ""

#: ../../library/xml.dom.rst:177
msgid ":class:`Document`"
msgstr ":class:`Document`"

#: ../../library/xml.dom.rst:177
msgid ":ref:`dom-document-objects`"
msgstr ":ref:`dom-document-objects`"

#: ../../library/xml.dom.rst:177
msgid "Object which represents an entire document."
msgstr ""

#: ../../library/xml.dom.rst:180
msgid ":class:`Element`"
msgstr ":class:`Element`"

#: ../../library/xml.dom.rst:180
msgid ":ref:`dom-element-objects`"
msgstr ":ref:`dom-element-objects`"

#: ../../library/xml.dom.rst:180
msgid "Element nodes in the document hierarchy."
msgstr ""

#: ../../library/xml.dom.rst:183
msgid ":class:`Attr`"
msgstr ":class:`Attr`"

#: ../../library/xml.dom.rst:183
msgid ":ref:`dom-attr-objects`"
msgstr ":ref:`dom-attr-objects`"

#: ../../library/xml.dom.rst:183
msgid "Attribute value nodes on element nodes."
msgstr ""

#: ../../library/xml.dom.rst:186
msgid ":class:`Comment`"
msgstr ":class:`Comment`"

#: ../../library/xml.dom.rst:186
msgid ":ref:`dom-comment-objects`"
msgstr ":ref:`dom-comment-objects`"

#: ../../library/xml.dom.rst:186
msgid "Representation of comments in the source document."
msgstr ""

#: ../../library/xml.dom.rst:189
msgid ":class:`Text`"
msgstr ":class:`Text`"

#: ../../library/xml.dom.rst:189
msgid ":ref:`dom-text-objects`"
msgstr ":ref:`dom-text-objects`"

#: ../../library/xml.dom.rst:189
msgid "Nodes containing textual content from the document."
msgstr ""

#: ../../library/xml.dom.rst:192
msgid ":class:`ProcessingInstruction`"
msgstr ":class:`ProcessingInstruction`"

#: ../../library/xml.dom.rst:192
msgid ":ref:`dom-pi-objects`"
msgstr ":ref:`dom-pi-objects`"

#: ../../library/xml.dom.rst:192
msgid "Processing instruction representation."
msgstr ""

#: ../../library/xml.dom.rst:196
msgid ""
"An additional section describes the exceptions defined for working with the "
"DOM in Python."
msgstr ""

#: ../../library/xml.dom.rst:203
msgid "DOMImplementation Objects"
msgstr "DOMImplementation 物件"

#: ../../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 ""

#: ../../library/xml.dom.rst:213
msgid ""
"Return ``True`` if the feature identified by the pair of strings *feature* "
"and *version* is implemented."
msgstr ""

#: ../../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 ""

#: ../../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 ""

#: ../../library/xml.dom.rst:237
msgid "Node Objects"
msgstr ""

#: ../../library/xml.dom.rst:239
msgid ""
"All of the components of an XML document are subclasses of :class:`Node`."
msgstr ""

#: ../../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 ""

#: ../../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 ""

#: ../../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 ""

#: ../../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 ""

#: ../../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 ""

#: ../../library/xml.dom.rst:287
msgid ""
"A list of nodes contained within this node. This is a read-only attribute."
msgstr ""

#: ../../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 ""

#: ../../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 ""

#: ../../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 ""

#: ../../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 ""

#: ../../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 ""

#: ../../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 ""

#: ../../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 ""

#: ../../library/xml.dom.rst:338
msgid "Return ``True`` if the node has any attributes."
msgstr ""

#: ../../library/xml.dom.rst:343
msgid "Return ``True`` if the node has any child nodes."
msgstr ""

#: ../../library/xml.dom.rst:348
msgid ""
"Return ``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 ""

#: ../../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 ""

#: ../../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 ""

#: ../../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 ""

#: ../../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 ""

#: ../../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 ""

#: ../../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 ""

#: ../../library/xml.dom.rst:397
msgid ""
"Clone this node.  Setting *deep* means to clone all child nodes as well.  "
"This returns the clone."
msgstr ""

#: ../../library/xml.dom.rst:404
msgid "NodeList Objects"
msgstr "NodeList 物件"

#: ../../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 ""

#: ../../library/xml.dom.rst:412
msgid ""
"The DOM Level 2 recommendation defines one method and one attribute for "
"these objects:"
msgstr ""

#: ../../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 ""

#: ../../library/xml.dom.rst:425
msgid "The number of nodes in the sequence."
msgstr ""

#: ../../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 ""

#: ../../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 ""

#: ../../library/xml.dom.rst:443
msgid "DocumentType Objects"
msgstr "DocumentType 物件"

#: ../../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 ""

#: ../../library/xml.dom.rst:453
msgid ""
":class:`DocumentType` is a specialization of :class:`Node`, and adds the "
"following attributes:"
msgstr ""

#: ../../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 ""

#: ../../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 ""

#: ../../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 ""

#: ../../library/xml.dom.rst:478
msgid ""
"The name of the root element as given in the ``DOCTYPE`` declaration, if "
"present."
msgstr ""

#: ../../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 ""

#: ../../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 ""

#: ../../library/xml.dom.rst:503
msgid "Document Objects"
msgstr ""

#: ../../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 ""

#: ../../library/xml.dom.rst:512
msgid "The one and only root element of the document."
msgstr ""

#: ../../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 ""

#: ../../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 ""

#: ../../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 ""

#: ../../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 ""

#: ../../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 ""

#: ../../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 ""

#: ../../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 ""

#: ../../library/xml.dom.rst:569
msgid ""
"Search for all descendants (direct children, children's children, etc.) with "
"a particular element type name."
msgstr ""

#: ../../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 ""

#: ../../library/xml.dom.rst:583
msgid "Element Objects"
msgstr ""

#: ../../library/xml.dom.rst:585
msgid ""
":class:`Element` is a subclass of :class:`Node`, so inherits all the "
"attributes of that class."
msgstr ""

#: ../../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 ""

#: ../../library/xml.dom.rst:597 ../../library/xml.dom.rst:602
msgid "Same as equivalent method in the :class:`Document` class."
msgstr ""

#: ../../library/xml.dom.rst:607
msgid "Return ``True`` if the element has an attribute named by *name*."
msgstr ""

#: ../../library/xml.dom.rst:612
msgid ""
"Return ``True`` if the element has an attribute named by *namespaceURI* and "
"*localName*."
msgstr ""

#: ../../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 ""

#: ../../library/xml.dom.rst:624
msgid "Return the :class:`Attr` node for the attribute named by *attrname*."
msgstr ""

#: ../../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 ""

#: ../../library/xml.dom.rst:636
msgid ""
"Return an attribute value as a node, given a *namespaceURI* and *localName*."
msgstr ""

#: ../../library/xml.dom.rst:641
msgid ""
"Remove an attribute by name.  If there is no matching attribute, a :exc:"
"`NotFoundErr` is raised."
msgstr ""

#: ../../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 ""

#: ../../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 ""

#: ../../library/xml.dom.rst:659
msgid "Set an attribute value from a string."
msgstr ""

#: ../../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 ""

#: ../../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 ""

#: ../../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 ""

#: ../../library/xml.dom.rst:687
msgid "Attr Objects"
msgstr ""

#: ../../library/xml.dom.rst:689
msgid ""
":class:`Attr` inherits from :class:`Node`, so inherits all its attributes."
msgstr ""

#: ../../library/xml.dom.rst:694
msgid ""
"The attribute name. In a namespace-using document it may include a colon."
msgstr ""

#: ../../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 ""

#: ../../library/xml.dom.rst:707
msgid ""
"The part of the name preceding the colon if there is one, else the empty "
"string."
msgstr ""

#: ../../library/xml.dom.rst:713
msgid ""
"The text value of the attribute.  This is a synonym for the :attr:"
"`nodeValue` attribute."
msgstr ""

#: ../../library/xml.dom.rst:720
msgid "NamedNodeMap Objects"
msgstr "NamedNodeMap 物件"

#: ../../library/xml.dom.rst:722
msgid ":class:`NamedNodeMap` does *not* inherit from :class:`Node`."
msgstr ""

#: ../../library/xml.dom.rst:727
msgid "The length of the attribute list."
msgstr ""

#: ../../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 ""

#: ../../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 ""

#: ../../library/xml.dom.rst:744
msgid "Comment Objects"
msgstr ""

#: ../../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 ""

#: ../../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 ""

#: ../../library/xml.dom.rst:760
msgid "Text and CDATASection Objects"
msgstr ""

#: ../../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 ""

#: ../../library/xml.dom.rst:768
msgid ""
"These interfaces extend the :class:`Node` interface.  They cannot have child "
"nodes."
msgstr ""

#: ../../library/xml.dom.rst:774
msgid "The content of the text node as a string."
msgstr ""

#: ../../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 ""

#: ../../library/xml.dom.rst:788
msgid "ProcessingInstruction Objects"
msgstr "ProcessingInstruction 物件"

#: ../../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 ""

#: ../../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 ""

#: ../../library/xml.dom.rst:802
msgid ""
"The content of the processing instruction following the first whitespace "
"character."
msgstr ""

#: ../../library/xml.dom.rst:809
msgid "Exceptions"
msgstr "例外"

#: ../../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 ""

#: ../../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 ""

#: ../../library/xml.dom.rst:825
msgid ""
"Base exception class used for all specific DOM exceptions.  This exception "
"class cannot be directly instantiated."
msgstr ""

#: ../../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 ""

#: ../../library/xml.dom.rst:838
msgid ""
"Raised when an attempt is made to insert a node where the node type is not "
"allowed."
msgstr ""

#: ../../library/xml.dom.rst:844
msgid ""
"Raised when an index or size parameter to a method is negative or exceeds "
"the allowed values."
msgstr ""

#: ../../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 ""

#: ../../library/xml.dom.rst:856
msgid ""
"Raised if a parameter or an operation is not supported on the underlying "
"object."
msgstr ""

#: ../../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 ""

#: ../../library/xml.dom.rst:869
msgid "Raised when an attempt is made to modify the type of a node."
msgstr ""

#: ../../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 ""

#: ../../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 ""

#: ../../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 ""

#: ../../library/xml.dom.rst:894
msgid ""
"Raised when the implementation does not support the requested type of object "
"or operation."
msgstr ""

#: ../../library/xml.dom.rst:900
msgid ""
"This is raised if data is specified for a node which does not support data."
msgstr ""

#: ../../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 ""

#: ../../library/xml.dom.rst:913
msgid "Raised when an invalid or illegal string is specified."
msgstr ""

#: ../../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 ""

#: ../../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 ""

#: ../../library/xml.dom.rst:928
msgid "Constant"
msgstr "常數"

#: ../../library/xml.dom.rst:928
msgid "Exception"
msgstr "例外"

#: ../../library/xml.dom.rst:930
msgid ":const:`DOMSTRING_SIZE_ERR`"
msgstr ":const:`DOMSTRING_SIZE_ERR`"

#: ../../library/xml.dom.rst:930
msgid ":exc:`DomstringSizeErr`"
msgstr ":exc:`DomstringSizeErr`"

#: ../../library/xml.dom.rst:932
msgid ":const:`HIERARCHY_REQUEST_ERR`"
msgstr ":const:`HIERARCHY_REQUEST_ERR`"

#: ../../library/xml.dom.rst:932
msgid ":exc:`HierarchyRequestErr`"
msgstr ":exc:`HierarchyRequestErr`"

#: ../../library/xml.dom.rst:934
msgid ":const:`INDEX_SIZE_ERR`"
msgstr ":const:`INDEX_SIZE_ERR`"

#: ../../library/xml.dom.rst:934
msgid ":exc:`IndexSizeErr`"
msgstr ":exc:`IndexSizeErr`"

#: ../../library/xml.dom.rst:936
msgid ":const:`INUSE_ATTRIBUTE_ERR`"
msgstr ":const:`INUSE_ATTRIBUTE_ERR`"

#: ../../library/xml.dom.rst:936
msgid ":exc:`InuseAttributeErr`"
msgstr ":exc:`InuseAttributeErr`"

#: ../../library/xml.dom.rst:938
msgid ":const:`INVALID_ACCESS_ERR`"
msgstr ":const:`INVALID_ACCESS_ERR`"

#: ../../library/xml.dom.rst:938
msgid ":exc:`InvalidAccessErr`"
msgstr ":exc:`InvalidAccessErr`"

#: ../../library/xml.dom.rst:940
msgid ":const:`INVALID_CHARACTER_ERR`"
msgstr ":const:`INVALID_CHARACTER_ERR`"

#: ../../library/xml.dom.rst:940
msgid ":exc:`InvalidCharacterErr`"
msgstr ":exc:`InvalidCharacterErr`"

#: ../../library/xml.dom.rst:942
msgid ":const:`INVALID_MODIFICATION_ERR`"
msgstr ":const:`INVALID_MODIFICATION_ERR`"

#: ../../library/xml.dom.rst:942
msgid ":exc:`InvalidModificationErr`"
msgstr ":exc:`InvalidModificationErr`"

#: ../../library/xml.dom.rst:944
msgid ":const:`INVALID_STATE_ERR`"
msgstr ":const:`INVALID_STATE_ERR`"

#: ../../library/xml.dom.rst:944
msgid ":exc:`InvalidStateErr`"
msgstr ":exc:`InvalidStateErr`"

#: ../../library/xml.dom.rst:946
msgid ":const:`NAMESPACE_ERR`"
msgstr ":const:`NAMESPACE_ERR`"

#: ../../library/xml.dom.rst:946
msgid ":exc:`NamespaceErr`"
msgstr ":exc:`NamespaceErr`"

#: ../../library/xml.dom.rst:948
msgid ":const:`NOT_FOUND_ERR`"
msgstr ":const:`NOT_FOUND_ERR`"

#: ../../library/xml.dom.rst:948
msgid ":exc:`NotFoundErr`"
msgstr ":exc:`NotFoundErr`"

#: ../../library/xml.dom.rst:950
msgid ":const:`NOT_SUPPORTED_ERR`"
msgstr ":const:`NOT_SUPPORTED_ERR`"

#: ../../library/xml.dom.rst:950
msgid ":exc:`NotSupportedErr`"
msgstr ":exc:`NotSupportedErr`"

#: ../../library/xml.dom.rst:952
msgid ":const:`NO_DATA_ALLOWED_ERR`"
msgstr ":const:`NO_DATA_ALLOWED_ERR`"

#: ../../library/xml.dom.rst:952
msgid ":exc:`NoDataAllowedErr`"
msgstr ":exc:`NoDataAllowedErr`"

#: ../../library/xml.dom.rst:954
msgid ":const:`NO_MODIFICATION_ALLOWED_ERR`"
msgstr ":const:`NO_MODIFICATION_ALLOWED_ERR`"

#: ../../library/xml.dom.rst:954
msgid ":exc:`NoModificationAllowedErr`"
msgstr ":exc:`NoModificationAllowedErr`"

#: ../../library/xml.dom.rst:956
msgid ":const:`SYNTAX_ERR`"
msgstr ":const:`SYNTAX_ERR`"

#: ../../library/xml.dom.rst:956
msgid ":exc:`SyntaxErr`"
msgstr ":exc:`SyntaxErr`"

#: ../../library/xml.dom.rst:958
msgid ":const:`WRONG_DOCUMENT_ERR`"
msgstr ":const:`WRONG_DOCUMENT_ERR`"

#: ../../library/xml.dom.rst:958
msgid ":exc:`WrongDocumentErr`"
msgstr ":exc:`WrongDocumentErr`"

#: ../../library/xml.dom.rst:965
msgid "Conformance"
msgstr ""

#: ../../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 ""

#: ../../library/xml.dom.rst:975
msgid "Type Mapping"
msgstr ""

#: ../../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 ""

#: ../../library/xml.dom.rst:981
msgid "IDL Type"
msgstr ""

#: ../../library/xml.dom.rst:981
msgid "Python Type"
msgstr "Python Type"

#: ../../library/xml.dom.rst:983
msgid "``boolean``"
msgstr "``boolean``"

#: ../../library/xml.dom.rst:983
msgid "``bool`` or ``int``"
msgstr "``bool`` 或 ``int``"

#: ../../library/xml.dom.rst:985 ../../library/xml.dom.rst:987
#: ../../library/xml.dom.rst:989
msgid "``int``"
msgstr "``int``"

#: ../../library/xml.dom.rst:987
msgid "``long int``"
msgstr "``long int``"

#: ../../library/xml.dom.rst:989
msgid "``unsigned int``"
msgstr "``unsigned int``"

#: ../../library/xml.dom.rst:991
msgid "``DOMString``"
msgstr "``DOMString``"

#: ../../library/xml.dom.rst:991
msgid "``str`` or ``bytes``"
msgstr "``str`` 或 ``bytes``"

#: ../../library/xml.dom.rst:993
msgid "``null``"
msgstr "``null``"

#: ../../library/xml.dom.rst:993
msgid "``None``"
msgstr "``None``"

#: ../../library/xml.dom.rst:999
msgid "Accessor Methods"
msgstr ""

#: ../../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 ""

#: ../../library/xml.dom.rst:1005
msgid ""
"readonly attribute string someValue;\n"
"         attribute string anotherValue;"
msgstr ""
"readonly attribute string someValue;\n"
"         attribute string anotherValue;"

#: ../../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 ""

#: ../../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 ""

#: ../../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 ""

#: ../../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 ""