.. _functx_sort:

===========
functx:sort
=========== 

Ordena uma sequência de valores ou de nós

Descrição
~~~~~~~~~
A função functx:sort ordena uma sequência de valores ou de nós. Se receber nós, 
compara os valores tipados deles (se não tiverem tipo, são tratados como 
strings). Dá para fazer o mesmo com uma cláusula order by, mas a função deixa a 
consulta mais curta, sem precisar escrever uma expressão FLWOR só para ordenar.

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

   * - **Parâmetros**
     - **Descrição**
   * - seq:item()
     - a sequência a ordenar

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

.. code-block:: xml

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

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

   * - **XPath**
     - **Resultado**
   * - functx:sort(('c','a','b'))
     - ('a', 'b', 'c')
   * - functx:sort($in-xml/\*)
     - <f>a</f> <e>b</e> <f>c</f>

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

.. toctree::
   :titlesonly:
   :glob:

* :ref:`functx_sort-as-numeric`.
* :ref:`functx_sort-case-insensitive`.
* :ref:`functx_sort-document-order`.