.. _functx_index-of-match-first:

===========================
functx:index-of-match-first
=========================== 

A primeira posição de um trecho que casa com um padrão

Descrição
~~~~~~~~~
A função functx:index-of-match-first devolve um inteiro com a primeira posição, 
dentro de $arg, de um trecho que casa com $pattern. Se $arg não casar com 
$pattern, devolve a sequência vazia.

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

   * - **Parâmetros**
     - **Descrição**
   * - arg:string()
     - a string
   * - pattern:string()
     - o padrão a procurar

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

   * - **XPath**
     - **Resultado**
   * - functx:index-of-match-first('abcdabcdabcd','abc')
     - 1
   * - functx:index-of-match-first('abcdabcdabcd','bcd')
     - 2
   * - functx:index-of-match-first('a1234','\\d')
     - 2
   * - functx:index-of-match-first('abc abc','\\s')
     - 4
   * - functx:index-of-match-first('abc abc','z')
     - ()

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

.. toctree::
   :titlesonly:
   :glob:

* :ref:`functx_index-of-string-first`.