.. _index-of:

========
index-of
======== 

A posição (ou as posições) de um valor atômico numa sequência

Descrição
~~~~~~~~~
A função fn:index-of devolve a posição (ou as posições) de um valor atômico numa 
sequência. O argumento $seqParam é a sequência onde procurar, e $srchParam é o 
valor procurado. A função devolve uma sequência de inteiros com as posições do 
valor na sequência, em ordem, começando em 1 (não em 0).

A sequência $seqParam precisa ter só valores atômicos, ou nós com valor tipado 
atômico. Os itens são comparados com o valor procurado pelo valor tipado, e não 
pela identidade do nó. Valores sem tipo são tratados como strings.

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

   * - **Parâmetros**
     - **Descrição**
   * - seqParam:string()
     - a sequência de valores
   * - srchParam:string()
     - o valor cuja posição se quer achar
   * - collation:string()
     - a collation usada para comparar strings

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

   * - **XPath**
     - **Resultado**
   * - index-of( ('a', 'b', 'c'), 'a')
     - 1
   * - index-of( ('a', 'b', 'c'), 'd')
     - ()
   * - index-of( (4, 5, 6, 4), 4)
     - (1, 4)
   * - index-of( (4, 5, 6, 4), 04.0)
     - (1, 4)
   * - index-of( ('a', 5, 6), 'a')
     - 1
   * - index-of( (), 'a')
     - ()
   * - index-of( (<a>1</a>, <b>1</b>), <c>1</c> )
     - (1, 2)

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

.. toctree::
   :titlesonly:
   :glob:

* :ref:`functx_index-of-node`.
* :ref:`functx_index-of-deep-equal-node`.
* :ref:`position`.