.. _min:

===
min
=== 

O menor valor de uma sequência

Descrição
~~~~~~~~~
A função fn:min acha o menor valor de uma sequência. A sequência $arg só pode 
ter valores de um tipo, ou de tipos derivados dele. A exceção é quando todos são 
numéricos; aí valem as regras de promoção numérica. O tipo precisa ser 
ordenável: deve ser possível comparar os valores com os operadores < e >.

A função fn:min supõe que valores sem tipo são numéricos, a menos que sejam 
convertidos explicitamente em xs:string. Para tratar dados sem tipo como 
strings, use a função fn:string, como no último exemplo abaixo.

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

   * - **Parâmetros**
     - **Descrição**
   * - arg:integer()
     - a sequência de valores
   * - collation:string()
     - a collation usada para comparar strings

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

.. code-block:: xml

   <xsl:variable name="ordDoc" select="doc('http://www.functx.com/input/order.xml')"/>
   
   <!-- content of order.xml -->
   <order num="00299432" date="2006-09-15" cust="0221A">
     <item dept="WMN" num="557" quantity="1" color="beige"/>
     <item dept="ACC" num="563" quantity="1"/>
     <item dept="ACC" num="443" quantity="2"/>
     <item dept="MEN" num="784" quantity="1" color="blue/white"/>
     <item dept="MEN" num="784" quantity="1" color="blue/red"/>
     <item dept="WMN" num="557" quantity="1" color="sage"/>
   </order>

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

   * - **XPath**
     - **Resultado**
   * - min( (2.0, 1, 3.5, 4) )
     - 1
   * - min( ('a', 'b', 'c') )
     - a
   * - min($ordDoc//item/@color)
     - Error FORG0006, if color is untyped
   * - min($ordDoc//item//string(@color))
     - zero-length string
   * - min($ordDoc//item/@color/string(.))
     - beige

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

.. toctree::
   :titlesonly:
   :glob:

* :ref:`functx_min-determine-type`.
* :ref:`functx_min-node`.
* :ref:`functx_min-string`.
* :ref:`functx_min-non-empty-string`.
* :ref:`max`.