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
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
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
QName.namespaceURI
(or QName.prefix
)
property is to be resolved.
contextElements
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.
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}