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.
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
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 |