.. _name:

====
name
==== 

O nome qualificado de um nó, como string

Descrição
~~~~~~~~~
A função fn:name devolve o nome qualificado de um nó, como string. Se o nome do 
nó não estiver num namespace, devolve a parte local do nome, sem prefixo. Senão, 
a string é o prefixo do namespace, mais dois-pontos (":"), mais a parte local. 
Se o nome estiver no namespace padrão, o resultado pode vir sem prefixo.

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

   * - **Parâmetros**
     - **Descrição**
   * - arg:node()
     - o nó; se omitido, o nó de contexto

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**
   * - name($in-xml)
     - 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**
   * - name($in-xml//pre2:prefixed)
     - pre:prefixed
   * - name($in-xml//unpre2:unprefixed)
     - unprefixed
   * - name($in-xml//@pre2:prefAttr)
     - pre:prefAttr
   * - name($in-xml//@noNSAttr)
     - noNSAttr

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

.. toctree::
   :titlesonly:
   :glob:

* :ref:`local-name`.
* :ref:`node-name`.