.. _normalize-space:

===============
normalize-space
=============== 

Normaliza os espaços em branco

Descrição
~~~~~~~~~
A função fn:normalize-space junta os espaços em branco de uma string. Ela faz 
três coisas:

    1. Troca cada retorno de carro (#xD), nova linha (#xA) e tabulação (#x9) por 
um espaço (#x20)

    2. Junta os espaços seguidos num espaço só

    3. Remove os espaços do início e do fim

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

   * - **Parâmetros**
     - **Descrição**
   * - arg:string()
     - a string a normalizar; se omitida, o valor de string do item de contexto

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

   * - **XPath**
     - **Resultado**
   * - normalize-space('query')
     - query
   * - normalize-space(' query ')
     - query
   * - normalize-space('xml query')
     - xml query
   * - normalize-space('xml       query')
     - xml query
   * - normalize-space('xml query')
     - xml query
   * - normalize-space('')
     - zero-length string
   * - normalize-space('   ')
     - zero-length string
   * - normalize-space(())
     - zero-length string
   * - normalize-space(<element>   query  </element>)
     - query

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

.. toctree::
   :titlesonly:
   :glob:

* :ref:`functx_trim`.
* :ref:`functx_left-trim`.
* :ref:`functx_right-trim`.