.. _functx_contains-word:

====================
functx:contains-word
==================== 

Se uma string contém outra como palavra separada

Descrição
~~~~~~~~~
A função functx:contains-word devolve true se $word estiver em $arg como palavra 
separada. Ela precisa estar entre caracteres que não são de palavra, ou no 
início ou no fim de $arg. A comparação não diferencia maiúsculas de minúsculas.

Um "caractere que não é de palavra" é um que, no Unicode, pertence às categorias 
Pontuação, Separadores ou Outros. Em geral, quase toda pontuação e todo espaço 
em branco não são caracteres de palavra, enquanto letras e dígitos são.

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

   * - **Parâmetros**
     - **Descrição**
   * - arg:string()
     - a string onde procurar
   * - word:string()
     - a palavra a procurar

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

   * - **XPath**
     - **Resultado**
     - **Explicação**
   * - functx:contains-word('abc def ghi', 'def')
     - true
     - def está separado por espaços.
   * - functx:contains-word('abc.def\\ghi', 'def')
     - true
     - Qualquer caractere que não é de palavra separa palavras, como . e \\.
   * - functx:contains-word('abc def ghi', 'abc')
     - true
     - Pode estar no início ou no fim.
   * - functx:contains-word('abc', 'abc')
     - true
     - Pode ser o valor inteiro.
   * - functx:contains-word('abcdef', 'abc')
     - false
     - abc não aparece como palavra separada.

Depende de
~~~~~~~~~~
* :ref:`functx_escape-for-regex`.

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

.. toctree::
   :titlesonly:
   :glob:

* :ref:`contains`.