The PySide.QtXml.QDomNamedNodeMap class contains a collection of nodes that can be accessed by name.
Note that PySide.QtXml.QDomNamedNodeMap does not inherit from PySide.QtXml.QDomNodeList . QDomNamedNodeMaps do not provide any specific node ordering. Although nodes in a PySide.QtXml.QDomNamedNodeMap may be accessed by an ordinal index, this is simply to allow a convenient enumeration of the contents of a PySide.QtXml.QDomNamedNodeMap , and does not imply that the DOM specifies an ordering of the nodes.
The PySide.QtXml.QDomNamedNodeMap is used in three places:
Items in the map are identified by the name which QDomNode::name() returns. Nodes are retrieved using PySide.QtXml.QDomNamedNodeMap.namedItem() , PySide.QtXml.QDomNamedNodeMap.namedItemNS() or PySide.QtXml.QDomNamedNodeMap.item() . New nodes are inserted with PySide.QtXml.QDomNamedNodeMap.setNamedItem() or PySide.QtXml.QDomNamedNodeMap.setNamedItemNS() and removed with PySide.QtXml.QDomNamedNodeMap.removeNamedItem() or PySide.QtXml.QDomNamedNodeMap.removeNamedItemNS() . Use PySide.QtXml.QDomNamedNodeMap.contains() to see if an item with the given name is in the named node map. The number of items is returned by PySide.QtXml.QDomNamedNodeMap.length() .
Terminology: in this class we use “item” and “node” interchangeably.
Parameters: | arg__1 – PySide.QtXml.QDomNamedNodeMap |
---|
Constructs an empty named node map.
Constructs a copy of n .
Parameters: | name – unicode |
---|---|
Return type: | PySide.QtCore.bool |
Returns true if the map contains a node called name ; otherwise returns false.
Note
This function does not take the presence of namespaces into account. Use PySide.QtXml.QDomNamedNodeMap.namedItemNS() to test whether the map contains a node with a specific namespace URI and name.
Return type: | PySide.QtCore.int |
---|
This function is provided for Qt API consistency. It is equivalent to PySide.QtXml.QDomNamedNodeMap.length() .
Return type: | PySide.QtCore.bool |
---|
Returns true if the map is empty; otherwise returns false. This function is provided for Qt API consistency.
Parameters: | index – PySide.QtCore.int |
---|---|
Return type: | PySide.QtXml.QDomNode |
Retrieves the node at position index .
This can be used to iterate over the map. Note that the nodes in the map are ordered arbitrarily.
Return type: | PySide.QtCore.uint |
---|
Returns the number of nodes in the map.
See also
Parameters: | name – unicode |
---|---|
Return type: | PySide.QtXml.QDomNode |
Returns the node called name .
If the named node map does not contain such a node, a null node is returned. A node’s name is the name returned by QDomNode.nodeName() .
Parameters: |
|
---|---|
Return type: |
Returns the node associated with the local name localName and the namespace URI nsURI .
If the map does not contain such a node, a null node is returned.
Parameters: | arg__1 – PySide.QtXml.QDomNamedNodeMap |
---|---|
Return type: | PySide.QtCore.bool |
Returns true if n and this named node map are not equal; otherwise returns false.
Parameters: | arg__1 – PySide.QtXml.QDomNamedNodeMap |
---|---|
Return type: | PySide.QtCore.bool |
Returns true if n and this named node map are equal; otherwise returns false.
Parameters: | name – unicode |
---|---|
Return type: | PySide.QtXml.QDomNode |
Removes the node called name from the map.
The function returns the removed node or a null node if the map did not contain a node called name .
Parameters: |
|
---|---|
Return type: |
Removes the node with the local name localName and the namespace URI nsURI from the map.
The function returns the removed node or a null node if the map did not contain a node with the local name localName and the namespace URI nsURI .
Parameters: | newNode – PySide.QtXml.QDomNode |
---|---|
Return type: | PySide.QtXml.QDomNode |
Inserts the node newNode into the named node map. The name used by the map is the node name of newNode as returned by QDomNode.nodeName() .
If the new node replaces an existing node, i.e. the map contains a node with the same name, the replaced node is returned.
Parameters: | newNode – PySide.QtXml.QDomNode |
---|---|
Return type: | PySide.QtXml.QDomNode |
Inserts the node newNode in the map. If a node with the same namespace URI and the same local name already exists in the map, it is replaced by newNode . If the new node replaces an existing node, the replaced node is returned.
Return type: | PySide.QtCore.int |
---|
This function is provided for Qt API consistency. It is equivalent to PySide.QtXml.QDomNamedNodeMap.length() .