Como codificar texto em Base64

Utilidade da representação

A ferramenta Base64 Encode recebe texto não vazio e converte-o para bytes UTF-8 antes de apresentar a representação em Base64. Pode ser útil quando precisa de preparar uma mensagem para um campo ou uma troca de dados que aceite este formato. A conversão representa o conteúdo introduzido; não corresponde à descodificação de um valor já codificado.

O campo de texto é opcional e pode surgir vazio no início da utilização. Essa condição descreve apenas a entrada inicial: para obter uma conversão, terá de escrever conteúdo no campo antes de executar a operação. Letras, números, espaços, pontuação e caracteres acentuados podem fazer parte da mensagem, desde que o conteúdo efetivo não fique vazio.

A representação obtida pode não se parecer com a frase original. Isso acontece porque o texto é tratado como bytes UTF-8 e depois apresentado numa cadeia Base64. Para verificar o resultado, mantenha à mão a versão original e confirme que a entrada contém precisamente a mensagem que pretende preparar.

Passos para preparar a entrada

1. Abra a ferramenta Base64 Encode.
2. No campo de texto, introduza a mensagem que pretende converter. Escreva os acentos, espaços e sinais de pontuação tal como devem fazer parte do conteúdo final.
3. Leia novamente a entrada antes de continuar. Confirme que existe pelo menos um caráter e verifique se não ficaram de fora palavras, espaços relevantes ou sinais acrescentados por engano.
4. Inicie a operação de codificação.
5. Consulte o resultado apresentado e copie a cadeia Base64 para o destino previsto, se precisar de a reutilizar.

A conversão para UTF-8 é feita antes da representação em Base64. Por esse motivo, não substitua ã, ç, é ou € por códigos escritos manualmente. Introduza os caracteres originais e deixe que a ferramenta faça a transformação correspondente.

Se o campo tiver começado vazio, preenchê-lo é uma parte necessária da preparação. Quando o conteúdo efetivo continua vazio, a operação termina com um resultado sem sucesso em vez de produzir uma cadeia. Se também surgir uma exceção durante a conversão do texto, essa situação é devolvida como um resultado sem sucesso, não como uma exceção propagada para si. Depois de corrigir a entrada, execute novamente e reveja a versão apresentada.

Leitura do valor obtido

Numa execução bem-sucedida, o valor apresentado é uma cadeia em Base64 correspondente aos bytes UTF-8 do texto introduzido. A aparência dessa cadeia não serve, por si só, para confirmar a mensagem: compare-a com a entrada que preparou e confirme que não alterou caracteres, espaços ou pontuação antes de iniciar a operação.

Um resultado sem sucesso não deve ser interpretado como uma cadeia Base64 incompleta. Comece por verificar se o campo contém texto efetivo e, depois, reveja a entrada que foi submetida. Se a operação encontrar uma exceção durante a codificação, o resultado também pode indicar insucesso, pelo que será necessário corrigir o conteúdo ou tentar de novo com a versão pretendida.

O âmbito desta ferramenta é a codificação de texto. Não a trate como descodificador de Base64, codificador de ficheiros ou interface para processamento binário genérico. Se o seu objetivo for uma dessas operações, confirme primeiro que dispõe de uma solução com a capacidade correspondente, em vez de interpretar uma cadeia apresentada como se fosse uma mensagem descodificada.

Exemplo prático

Precisa de preparar a frase Olá, equipa! para um campo que aceite Base64 e introduz esse texto antes de iniciar a operação.

Introduza Olá, equipa! num campo de texto vazio e inicie a codificação. Confirme depois que foi apresentada uma cadeia Base64 e que a execução terminou com sucesso, sem calcular manualmente o valor desta mensagem específica neste exemplo concreto de utilização . Este caso permite observar o formato do resultado sem confundir a representação com uma descodificação.

A execução apresenta um resultado bem-sucedido com uma cadeia de caracteres em Base64 correspondente aos bytes UTF-8 de Olá, equipa!; o valor pode não ser legível como a frase original.

Limitações

• A operação recebe texto e faz codificação Base64; não deve ser tomada como descodificador, codificador de ficheiros ou processador binário genérico.

Erros comuns

• Executar com o campo ainda vazio termina sem sucesso porque não há texto efetivo para converter. Introduza uma mensagem não vazia e repita a operação.

Perguntas frequentes

Posso converter texto com acentos?

Sim, desde que o conteúdo introduzido não fique vazio. Os caracteres acentuados são tratados como parte do texto e convertidos para bytes UTF-8 antes de a cadeia ser representada em Base64; não precisa de os trocar por códigos.

A ferramenta também descodifica Base64 ou codifica ficheiros?

Não. A capacidade descrita recebe texto e faz a codificação Base64. Não deve interpretar a ferramenta como descodificador, codificador de ficheiros ou solução para processamento binário genérico quando precisa dessas operações.

Porque não aparece uma codificação sem texto?

O campo pode começar vazio porque a entrada foi definida como opcional, mas a execução não produz uma codificação quando o conteúdo efetivo continua vazio. Escreva uma mensagem antes de iniciar a operação e verifique o novo resultado.