.. _prefix-from-QName:

=================
prefix-from-QName
================= 

O prefixo de um QName

Descrição
~~~~~~~~~
A função fn:prefix-from-QName devolve o prefixo associado a um nome qualificado. 
Repare que o prefixo de um nome selecionado de um documento de entrada é o usado 
nesse documento, e não um prefixo usado na consulta.

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

   * - **Parâmetros**
     - **Descrição**
   * - arg:string()
     - o QName

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

.. code-block:: xml

   <xsl:stylesheet xmlns:pre2="http://datypic.com/pre"
                   xmlns:unpre="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: 25 25 50
   :header-rows: 1

   * - **XPath**
     - **Resultado**
     - **Explicação**
   * - prefix-from-QName(node-name($in-xml))
     - ()
     - noNamespace não tem prefixo.

O prefixo pre2 é usado no lugar de pre 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: 25 25 50
   :header-rows: 1

   * - **XPath**
     - **Resultado**
     - **Explicação**
   * - prefix-from-QName(node-name($in-xml//pre2:prefixed))
     - pre
     - O nome mantém o prefixo usado no documento de entrada, pre, embora a consulta use pre2.
   * - prefix-from-QName(node-name($in-xml//unpre:unprefixed))
     - ()
     - unprefixed está no namespace padrão, sem prefixo.
   * - prefix-from-QName(node-name($in-xml//@pre2:prefAttr))
     - pre
     - O atributo mantém o prefixo usado no documento de entrada.
   * - prefix-from-QName(node-name($in-xml//@noNSAttr))
     - ()
     - O atributo não tem prefixo.

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

.. toctree::
   :titlesonly:
   :glob:

* :ref:`local-name-from-QName`.
* :ref:`namespace-uri-from-QName`.
* :ref:`namespace-uri-for-prefix`.
* :ref:`in-scope-prefixes`.