Class QName
QName objects are used to represent qualified names of XML elements and attributes. Each QName object has a local name of type string and a namespace URI of type string or null. When the namespace URI is null, this qualified name matches any namespace.
If the QName of an XML element is specified without identifying a namespace (i.e., as an unqualified identifier), the uri property of the associated QName will be set to the in-scope default namespace. If the QName of an XML attribute is specified without identifying a namespace, the uri property of the associated QName will be the empty string representing no namespace.
| Property | Description |
|---|---|
localName: String (read-only) | Returns the local name of the QName object. |
uri: String (read-only) | Returns the Uniform Resource Identifier (URI) of the QName object. |
| Constructor | Description |
|---|---|
| QName() | Constructs a QName object where localName is set to an empty String. |
| QName(QName) | Constructs a QName object that is a copy of the specified qname. |
| QName(Namespace, QName) | Creates a QName object with a uri from a Namespace object and a localName from a QName object. |
| Method | Description |
|---|---|
| getLocalName() | Returns the local name of the QName object. |
| getUri() | Returns the Uniform Resource Identifier (URI) of the QName object. |
| toString() | Returns a string composed of the URI, and the local name for the QName object, separated by "::". |
assign, create, create, defineProperties, defineProperty, entries, freeze, fromEntries, getOwnPropertyDescriptor, getOwnPropertyNames, getOwnPropertySymbols, getPrototypeOf, hasOwnProperty, is, isExtensible, isFrozen, isPrototypeOf, isSealed, keys, preventExtensions, propertyIsEnumerable, seal, setPrototypeOf, toLocaleString, toString, valueOf, values
- localName: String
(read-only) Returns the local name of the QName object.
- uri: String
(read-only) Returns the Uniform Resource Identifier (URI) of the QName object.
- QName()
Constructs a QName object where localName is set to an empty String.
- QName(qname: QName)
Constructs a QName object that is a copy of the specified qname. If the argument is not a QName object, the argument is converted to a string and assigned to the localName property of the new QName instance.
Parameters:
- qname - the QName from which this QName will be constructed.
- QName(uri: Namespace, localName: QName)
Creates a QName object with a uri from a Namespace object and a localName from a QName object. If either argument is not the expected data type, the argument is converted to a string and assigned to the corresponding property of the new QName object.
Parameters:
- uri - a Namespace object from which to copy the uri value. An argument of any other type is converted to a string.
- localName - a QName object from which to copy the localName value. An argument of any other type is converted to a string.
- getLocalName(): String
Returns the local name of the QName object.
Returns:
- the local name of the QName object.
- getUri(): String
Returns the Uniform Resource Identifier (URI) of the QName object.
Returns:
- the Uniform Resource Identifier (URI) of the QName object.
- toString(): String
Returns a string composed of the URI, and the local name for the QName object, separated by "::". The format depends on the uri property of the QName object: If uri == "" toString returns localName else if uri == null toString returns *::localName else toString returns uri::localNam
Returns:
- a string composed of the URI, and the local name for the QName object, separated by "::".