.. _translate:

=========
translate
========= 

Troca caracteres avulsos

Descrição
~~~~~~~~~
A função fn:translate troca caracteres avulsos de uma string por outros 
caracteres avulsos. O argumento $mapString é a lista de caracteres a trocar, e 
$transString é a lista de caracteres novos. Cada caractere de $mapString é 
trocado pelo caractere da mesma posição em $transString. Se $mapString for maior 
que $transString, os caracteres de $mapString sem correspondente em $transString 
saem do resultado. Os caracteres da string original que não estão em $mapString 
passam sem mudança.

Repare que esta função serve só para trocar caracteres avulsos por outros, ou 
para remover caracteres avulsos. Para trocar sequências de caracteres, use 
fn:replace. Às vezes ela é usada para converter entre minúsculas e maiúsculas, 
mas as funções fn:upper-case e fn:lower-case fazem isso de forma mais completa, 
pelos mapeamentos do Unicode.

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

   * - **Parâmetros**
     - **Descrição**
   * - arg:string()
     - a string a traduzir
   * - mapString:string()
     - a string com os caracteres de origem
   * - transString:string()
     - a string com os caracteres de destino

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

   * - **XPath**
     - **Resultado**
   * - translate('1999/01/02', '/', '-')
     - 1999-01-02
   * - translate('xml query', 'qlmx', 'QLMX')
     - XML Query
   * - translate('xml query', 'qlmx ', 'Q')
     - Query
   * - translate('xml query', 'qlmx ', '')
     - uery
   * - translate('xml query', 'abcd', 'ABCD')
     - xml query
   * - translate('', 'qlmx ', 'Q')
     - zero-length string
   * - translate((), 'qlmx ', 'Q')
     - zero-length string