Como codificar texto para utilização num URL

Para que serve a codificação de texto para URL

O URL Encode serve para preparar texto para utilização num URL. Pode receber texto simples, incluindo espaços, símbolos especiais e caracteres Unicode, e transformá-lo numa representação adequada para esse contexto. É útil quando precisa de tratar um valor textual antes de o inserir numa parte de um URL, sem confundir essa tarefa com a validação ou a obtenção de um URL completo.

Como codificar o texto

Introduza no campo de texto o conteúdo que pretende codificar. O campo é opcional e apresenta, por predefinição, hello world & foo=bar; pode substituir esse exemplo pelo seu próprio texto.
Decida qual a representação de que precisa. Deixe a opção de codificação para consultas desativada para usar a representação padrão. Ative-a quando pretende uma representação própria de uma consulta. Esta opção é facultativa e está desativada por predefinição.
Se precisar de manter determinados caracteres durante a codificação principal, escreva-os na definição de caracteres a preservar. Por predefinição, essa definição está vazia, pelo que não são indicados caracteres para preservar.
Reveja o conteúdo introduzido e execute a operação. O resultado é apresentado como texto codificado para utilização num URL. Se o campo ficar vazio, a operação indica sucesso, mas apresenta uma indicação de erro em vez de um valor codificado; introduza texto não vazio para obter a representação pretendida.
Utilize o resultado no contexto apropriado. Antes de o incorporar numa aplicação ou num URL, confirme se a representação padrão ou a representação própria de consulta corresponde ao local onde o texto será utilizado.

Como interpretar o resultado

A opção escolhida altera a forma de representação, por isso deve corresponder ao contexto de utilização do texto. A opção de consulta não significa que o conteúdo tenha sido transformado num URL completo: a funcionalidade descrita é a codificação de texto fornecido para utilização num URL.

Quando o texto contém espaços, símbolos especiais ou caracteres Unicode, o resultado é uma representação codificada desses elementos. O resultado não deve ser interpretado como uma confirmação de que o URL final é válido, de que o destino existe ou de que o conteúdo pode ser obtido. Também convém distinguir uma indicação de erro associada a um campo vazio de um resultado de codificação: nesse caso, não há um valor codificado para reutilizar.

Exemplo prático

Uma pessoa precisa de preparar o texto hello world & foo=bar antes de o utilizar numa parte de um URL.

Introduza hello world & foo=bar, mantenha a opção de consulta desativada para a representação padrão e execute a operação. Depois, repita com a opção ativada para comparar a forma de representação escolhida.

O resultado tem a forma de uma representação textual codificada para utilização num URL; se o texto estiver vazio, surge uma indicação de erro em vez dessa representação.

Limitações

A funcionalidade descrita trata da codificação de texto. Não deve ser usada como confirmação de que um URL completo é válido, de que um destino existe ou de que o conteúdo de um endereço pode ser obtido.

Erros comuns

Introduzir um campo vazio e procurar um valor codificado: o resultado indica sucesso, mas inclui uma indicação de erro em vez de um valor. Corrija o conteúdo introduzindo texto não vazio antes de repetir a operação.

Perguntas frequentes

Posso codificar texto com espaços e símbolos especiais?

Sim, desde que o conteúdo seja texto não vazio. A ferramenta codifica espaços, símbolos especiais e caracteres Unicode para utilização num URL, mas não confirma a validade de um URL completo.

Quando devo ativar a opção de codificação para consultas?

Ative a definição de codificação para consultas quando precisar de uma representação própria de consulta; por predefinição, essa opção está desativada. Para a representação padrão, mantenha-a desativada.

O que acontece se eu deixar o campo de texto vazio?

Introduza texto não vazio. Com o campo vazio, a operação indica sucesso, mas fornece uma indicação de erro em vez de um valor codificado.