.. _functx_name-test:

================
functx:name-test
================ 

Se um nome corresponde a uma lista de nomes ou de curingas de nome

Descrição
~~~~~~~~~
A função functx:name-test testa um nome contra uma lista de nomes ou de curingas 
de nome. Os curingas válidos são:

*, que corresponde a todos os nomes

*:x, em que x é um nome local, que corresponde a todos os nomes com esse nome 
local, em qualquer namespace

p:*, em que p é um prefixo, que corresponde a todos os nomes no namespace 
associado a esse prefixo.

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

   * - **Parâmetros**
     - **Descrição**
   * - testname:string()
     - o nome a testar
   * - names:string()
     - a lista de nomes ou de curingas de nome

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

.. code-block:: xml

   <xsl:variable name="in-xml" as="item()*">
     <pre:a xmlns:pre="ns1">abc</pre:a>
   </xsl:variable>

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

   * - **XPath**
     - **Resultado**
   * - functx:name-test(name($in-xml),('\*'))
     - true
   * - functx:name-test(name($in-xml),('pre:\*'))
     - true
   * - functx:name-test(name($in-xml),('\*:a'))
     - true
   * - functx:name-test(name($in-xml),('pre:a','pre:b'))
     - true
   * - functx:name-test(name($in-xml),('a','b','c'))
     - false

Depende de
~~~~~~~~~~
* :ref:`functx_substring-after-if-contains`.