.. _functx_replace-beginning:

========================
functx:replace-beginning
======================== 

Substitui o início de uma string, até um padrão encontrado

Descrição
~~~~~~~~~
A função functx:replace-beginning substitui o início de $arg (até o primeiro 
trecho que casa com $pattern, inclusive) por $replacement. Se nenhum trecho 
casar com o padrão, nada é substituído.

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

   * - **Parâmetros**
     - **Descrição**
   * - arg:string()
     - a string inteira a alterar
   * - pattern:string()
     - o padrão de caracteres até onde substituir
   * - replacement:string()
     - a string de substituição

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

   * - **XPath**
     - **Resultado**
   * - functx:replace-beginning('abc-def', '-', 'xxx')
     - xxxdef
   * - functx:replace-beginning('abc-def', '-', '')
     - def
   * - functx:replace-beginning('---abc', '[a-z]', 'x')
     - xbc
   * - functx:replace-beginning('2004-12-05', '-', '2005-')
     - 2005-12-05

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

.. toctree::
   :titlesonly:
   :glob:

* :ref:`functx_replace-first`.
* :ref:`replace`.