.. _empty:

=====
empty
===== 

Se um valor é a sequência vazia

Descrição
~~~~~~~~~
A função fn:empty testa se a sequência está vazia, ou seja, se tem zero itens. 
Uma sequência não é considerada vazia só porque contém uma string vazia, o valor 
0 ou um elemento sem conteúdo.

Muitas vezes não é preciso chamar fn:empty, porque as sequências são convertidas 
automaticamente no valor booleano efetivo onde se espera um booleano.

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

   * - **Parâmetros**
     - **Descrição**
   * - arg:string()
     - a sequência a testar

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

.. code-block:: xml

   <xsl:variable name="in-xml" as="item()*">
     <in-xml>
       <a></a>
       <b/>
       <c>xyz</c>
     </in-xml>
   </xsl:variable>

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

   * - **XPath**
     - **Resultado**
     - **Explicação**
   * - empty( ('a', 'b', 'c') )
     - false
     - A sequência tem três itens.
   * - empty( () )
     - true
     - A sequência vazia não tem itens.
   * - empty(0)
     - false
     - 0 é um item; empty() não olha o valor dele.
   * - empty($in-xml/a)
     - false
     - O elemento a existe, mesmo sem conteúdo.
   * - empty($in-xml/b)
     - false
     - O elemento b existe, mesmo sem conteúdo.
   * - empty($in-xml/c)
     - false
     - O elemento c existe.
   * - empty($in-xml/foo)
     - true
     - Ou um erro estático, se a tipagem estática estiver ativa e foo não for um filho permitido.

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

.. toctree::
   :titlesonly:
   :glob:

* :ref:`exists`.
* :ref:`functx_if-empty`.
* :ref:`functx_if-absent`.
* :ref:`functx_all-whitespace`.