.. _escape-html-uri:

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

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

   * - **Parâmetros**
     - **Descrição**
   * - uri:string()
     - o URI a codificar

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

   * - **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
~~~~~~~~~~~

.. toctree::
   :titlesonly:
   :glob:

* :ref:`encode-for-uri`.
* :ref:`iri-to-uri`.