.. _collection:

==========
collection
========== 

Abre uma coleção

Descrição
~~~~~~~~~
A função fn:collection devolve uma coleção, que pode ser qualquer sequência de 
nós identificada por um URI. Muitas vezes devolve os nós de documento de vários 
documentos. Como o URI se liga aos nós é definido pela implementação. O Saxon, 
por exemplo, lê $arg para buscar um documento XML de coleção que lista todos os 
documentos dela. Um banco de dados pode permitir definir coleções (e incluir 
documentos nelas) pela interface do produto.

Se $arg for um URI relativo, ele é resolvido a partir do URI base do contexto 
estático. Esse URI base pode ser definido pelo processador fora da consulta ou 
declarado no prólogo da consulta.

A função fn:collection é estável. Ou seja, se você chamá-la mais de uma vez com 
o mesmo argumento, na mesma consulta, o resultado é o mesmo, mesmo que os 
recursos ligados ao URI tenham mudado.

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

   * - **Parâmetros**
     - **Descrição**
   * - arg:string()
     - o URI da coleção

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

   * - **XPath**
     - **Resultado**
   * - collection('http://www.functx.com/input/coll.xml')
     - for example, in Saxon, this will return all the document nodes of the XML documents mentioned in http://www.functx.com/input/coll.xml.

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

.. toctree::
   :titlesonly:
   :glob:

* :ref:`doc`.