.. _substring-before:

================
substring-before
================ 

O trecho antes da primeira ocorrência de um delimitador

Descrição
~~~~~~~~~
A função fn:substring-before extrai todos os caracteres de uma string ($arg1) 
que vêm antes da primeira ocorrência de outra string ($arg2).

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

   * - **Parâmetros**
     - **Descrição**
   * - arg1:string()
     - a string inteira
   * - arg2:string()
     - a string que encerra o trecho
   * - collation:string()
     - a collation usada para comparar strings

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

   * - **XPath**
     - **Resultado**
   * - substring-before('query', 'r')
     - que
   * - substring-before('query', 'ery')
     - qu
   * - substring-before('queryquery', 'ery')
     - qu
   * - substring-before('query', 'query')
     - zero-length string
   * - substring-before('query', 'x')
     - zero-length string
   * - substring-before('query', '')
     - zero-length string
   * - substring-before('query', ())
     - zero-length string

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

.. toctree::
   :titlesonly:
   :glob:

* :ref:`functx_substring-before-last`.
* :ref:`functx_substring-before-if-contains`.
* :ref:`substring`.
* :ref:`substring-after`.