.. _subsequence:

===========
subsequence
=========== 

Um trecho de uma sequência, a partir de uma posição inicial e de um tamanho

Descrição
~~~~~~~~~
A função fn:subsequence devolve uma sequência com $length itens de $sourceSeq, 
começando na posição $startingLoc. O primeiro item fica na posição 1, não em 0. 
Se $length não for informado, ou for maior que o número de itens disponíveis, a 
função vai até o fim da sequência. Uma alternativa a fn:subsequence é usar um 
predicado: por exemplo, fn:subsequence($a,3,4) equivale a $a[position() = (3 to 
6)].

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

   * - **Parâmetros**
     - **Descrição**
   * - sourceSeq:item()
     - a sequência inteira
   * - startingLoc:double()
     - a posição do primeiro item (começando em 1)
   * - length:double()
     - o número de itens a incluir

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

   * - **XPath**
     - **Resultado**
   * - subsequence(('a', 'b', 'c', 'd', 'e'), 3)
     - ('c', 'd', 'e')
   * - subsequence(('a', 'b', 'c', 'd', 'e'), 3, 2)
     - ('c', 'd')
   * - subsequence(('a', 'b', 'c', 'd', 'e'), 3, 10)
     - ('c', 'd', 'e')
   * - subsequence(('a', 'b', 'c', 'd', 'e'), 10)
     - ()
   * - subsequence(('a', 'b', 'c', 'd', 'e'), -2, 5)
     - ('a', 'b')
   * - subsequence( (), 3)
     - ()