.. _zero-or-one:

===========
zero-or-one
=========== 

Devolve a sequência se ela tiver zero ou um item; senão, dá erro

Descrição
~~~~~~~~~
A função fn:zero-or-one devolve $arg se ele tiver zero ou um item. Senão, dá o 
erro FORG0003. É útil quando a tipagem estática está ativa, para evitar erros de 
tipo estático aparentes.

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

   * - **Parâmetros**
     - **Descrição**
   * - arg:item()
     - a sequência que pode ter no máximo um item

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

   * - **XPath**
     - **Resultado**
   * - zero-or-one( () )
     - ()
   * - zero-or-one('a')
     - a
   * - zero-or-one( ('a', 'b') )
     - Error FORG0003

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

.. toctree::
   :titlesonly:
   :glob:

* :ref:`one-or-more`.
* :ref:`exactly-one`.