.. _key:

===
key
=== 

Devolve os nós que têm uma certa chave

Descrição
~~~~~~~~~
A função fn:key devolve os nós com uma certa chave. É parecida com fn:id, mas 
usa chaves em vez de IDs. Observação: é uma função só do XSLT; não existe em 
XQuery nem em XPath puro.

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

   * - **Parâmetros**
     - **Descrição**
   * - key-name:string()
     - o nome de uma declaração xsl:key
   * - key-value:string()
     - o valor a procurar
   * - top:node()
     - o nó cuja subárvore é pesquisada; opcional, por padrão o documento do nó de contexto

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

   * - **XPath**
     - **Resultado**
     - **Explicação**
   * - key('k', 'v')
     - Error: Key 'k' has not been defined
     - key() precisa de uma declaração xsl:key com esse nome.

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

.. toctree::
   :titlesonly:
   :glob:

* :ref:`id`.