escape-html-uri

Codifica todos os caracteres, menos os ASCII imprimíveis

Descrição

A função fn:escape-html-uri codifica todos os caracteres, menos os ASCII imprimíveis. Os agentes HTML exigem que alguns caracteres de URI sejam escritos com o code point Unicode em hexadecimal precedido de %. Isso inclui os caracteres não ASCII e alguns ASCII, como caracteres de controle, espaços e vários outros.

A função troca cada um desses caracteres especiais por uma sequência %xx, em que xx são dois dígitos hexadecimais (em maiúsculas) que representam o caractere em UTF-8. Por exemplo, édition.html vira %C3%A9dition.html, com o é escrito como %C3%A9. Mais precisamente, codifica tudo, menos os caracteres cujo code point decimal está entre 32 e 126, inclusive. Assim os URIs funcionam em agentes HTML, como navegadores, por exemplo em atributos href.

Parâmetros

Descrição

uri:string()

o URI a codificar

Exemplos

XPath

Resultado

escape-html-uri('http://datypic.com/édition 2.html')

http://datypic.com/%C3%A9dition%202.html

escape-html-uri('http://datypic.com/a%20URI#frag')

http://datypic.com/a%20URI#frag

escape-html-uri('http://datypic.com')

http://datypic.com

Veja também