Creates the detailed representation of the specified XML name according to the specified XML document context(s).

For more information about XML names and QName type, see references below.

Parameters:

qualifiedName

Specifies the XML qualified name by which the detailed XML name representation is to be created.

The qualified name will be split into the Namespace Prefix and Local Name parts.

Further, the prefix is resolved into a Namespace URI according to one or many XML document contexts specified with 'contextElement' or 'contextElements' parameter (see below).

If the namespace URI is found, it is assigned to QName.namespaceURI property along with the prefix and local name, which will be assigned to QName.prefix and QName.localName properties.

If neither of the provided contexts defines a namespace binding for the given prefix, both QName.namespaceURI and QName.prefix properties will set to null. The entire qualified name (passed in the parameter) will be assigned to QName.localName property.

Note: When this parameter is empty string, the function returns null.

namespaceURI
localName
Specify the Namespace URI and the Local Name that identify the XML name whose detailed representation is to be created.

These parameters provide values for QName.namespaceURI and QName.localName properties.

The value of QName.prefix property will be resolved from the specified namespace URI according to one or many XML document contexts specified with contextElement or contextElements parameter. If neither of the provided contexts defines bindings for such an URI, QName.prefix will be empty string.

Note: When localName parameter is empty string, the function does nothing and returns null.

contextElement
Specifies the element that determines the XML document context (i.e. position on the XML document's tree) against which the unknown value of QName.namespaceURI (or QName.prefix) property is to be resolved.
contextElements
Specifies the enumeration of elements that determine different XML document contexts.

The function starts from the first element and uses it to resolve the unknown value of QName.namespaceURI (or QName.prefix) property.

If the element's context does not define the necessary namespace URI/prefix binding, the function tries the next element from the enumeration and repeats so until the binding found or the last element reached.

Note: When neither contextElement nor contextElements parameter is specified, the generator context element will be used by default.

${include ../../../refs/qname_type_heading.htm}

${include ../../../gom/QName/doc.htm}