.. _contains:

========
contains
======== 

Se uma string contém outra

Descrição
~~~~~~~~~
A função fn:contains devolve true se $arg1 contiver os caracteres de $arg2 em 
qualquer ponto, inclusive no início ou no fim.

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

   * - **Parâmetros**
     - **Descrição**
   * - arg1:string()
     - a string a testar
   * - arg2:string()
     - o trecho a procurar
   * - collation:string()
     - a collation usada para comparar

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

   * - **XPath**
     - **Resultado**
   * - contains('query', 'e')
     - true
   * - contains('query', 'ery')
     - true
   * - contains('query', 'query')
     - true
   * - contains('query', 'x')
     - false
   * - contains('query', '')
     - true
   * - contains('query', ())
     - true
   * - contains( (), 'q')
     - false

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

.. toctree::
   :titlesonly:
   :glob:

* :ref:`functx_contains-word`.
* :ref:`functx_contains-case-insensitive`.
* :ref:`functx_contains-any-of`.
* :ref:`functx_index-of-string`.
* :ref:`functx_index-of-string-first`.
* :ref:`functx_index-of-string-last`.
* :ref:`starts-with`.
* :ref:`ends-with`.
* :ref:`matches`.