.. _position:

========
position
======== 

A posição atual no contexto

Descrição
~~~~~~~~~
A função fn:position devolve um inteiro com a posição (começando em 1, não em 0) 
do item de contexto atual dentro da sequência de contexto (a sequência de itens 
que está sendo processada).


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

.. code-block:: xml

   <xsl:variable name="in-xml" as="item()*">
     <in-xml>
          <a>1</a>
          <c>2</c>
          <a>3</a>
          <a>4</a>
          <a>5</a>
      </in-xml>
   </xsl:variable>

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

   * - **XPath**
     - **Resultado**
     - **Explicação**
   * - $in-xml/\*[position() > 2]
     - <a>3</a> <a>4</a> <a>5</a>
     - Todos os filhos depois do segundo.
   * - $in-xml/a[position() > 2]
     - <a>4</a> <a>5</a>
     - Os filhos a depois do segundo a; position() conta só os elementos a.
   * - $in-xml/a[position() = 3]
     - <a>4</a>
     - A expressão [position() = 3] equivale à expressão [3].

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

.. toctree::
   :titlesonly:
   :glob:

* :ref:`functx_first-node`.
* :ref:`functx_last-node`.
* :ref:`index-of`.
* :ref:`last`.