.. _node-name:

=========
node-name
========= 

O nome qualificado de um nó, como QName

Descrição
~~~~~~~~~
A função fn:node-name devolve o nome qualificado de um nó como xs:QName. Só faz 
sentido para nós de elemento, de atributo e de instrução de processamento. Para 
elementos e atributos, é simplesmente o nome usado no documento XML. Se o nome 
do nó não estiver em nenhum namespace, a parte de namespace do QName fica vazia, 
e a parte local é o nome.

.. list-table::
   :widths: 40 60
   :header-rows: 1

   * - **Parâmetros**
     - **Descrição**
   * - arg:node()
     - o nó

Exemplos
~~~~~~~~
Os exemplos abaixo usam este documento de entrada:

.. code-block:: xml

   <xsl:stylesheet xmlns:pre2="http://datypic.com/pre"
                   xmlns:unpre2="http://datypic.com/unpre">...
   
   <xsl:variable name="in-xml" as="item()*">
     <noNamespace>
       <pre:prefixed xmlns="http://datypic.com/unpre"
                xmlns:pre="http://datypic.com/pre">
         <unprefixed pre:prefAttr="a" noNSAttr="b">123</unprefixed>
       </pre:prefixed>
     </noNamespace>
   
   </xsl:variable>

.. list-table::
   :widths: 50 50
   :header-rows: 1

   * - **XPath**
     - **Resultado**
   * - node-name($in-xml)
     - A QName whose namespace is empty, whose prefix is empty, and whose local part is noNamespace

Os prefixos pre2 e unpre2 são usados no lugar de pre e unpre para mostrar que, ao selecionar nós de um documento, o prefixo devolvido é o usado no documento, e não o usado na consulta.

.. list-table::
   :widths: 50 50
   :header-rows: 1

   * - **XPath**
     - **Resultado**
   * - node-name($in-xml/pre2:prefixed)
     - A QName whose namespace is http://datypic.com/pre, whose prefix is pre, and whose local part is prefixed
   * - node-name($in-xml//unpre2:unprefixed)
     - A QName whose namespace is http://datypic.com/unpre, whose prefix is empty, and whose local part is unprefixed
   * - node-name($in-xml//@pre2:prefAttr)
     - A QName whose namespace is http://datypic.com/pre, whose prefix is pre, and whose local part is prefAttr
   * - node-name($in-xml//@noNSAttr)
     - A QName whose namespace is empty, whose prefix is empty, and whose local part is noNSAttr

Veja também
~~~~~~~~~~~

.. toctree::
   :titlesonly:
   :glob:

* :ref:`local-name`.
* :ref:`name`.
* :ref:`namespace-uri`.