Codificador xxencode

xxencode é uma codificação clássica de binário para texto aparentada com uuencode, mas troca o alfabeto de uu —cheio de espaços— por um conjunto de sessenta e quatro símbolos formado apenas por mais, menos, dígitos e letras. Esse desenho alfanumérico nasceu para que gateways de e-mail e sistemas EBCDIC não corrompessem a carga útil como costumavam fazer com fluxos uuencode. Quem busca um codificador ou decodificador xxencode costuma restaurar arquivos de e-mail antigos, interoperar com ferramentas Unix de transferência, ensinar história de codificações ao lado de Base64 ou precisar de um empacotamento determinístico e seguro em texto de mensagens UTF-8 curtas. A codificação é UTF-8 puro e empacotamento de seis bits; a decodificação aceita invólucros begin e end opcionais, remove linhas em branco e rejeita símbolos ilegais em vez de repará-los em silêncio.

Codificar texto UTF-8 em xxencode clássico

O motor interpreta a string como texto Unicode, serializa-a em bytes UTF-8 e envolve esses bytes na forma clássica begin e end usada por ferramentas históricas de xxencode. Cada linha do corpo começa com um caractere de comprimento tirado do mesmo alfabeto de sessenta e quatro símbolos, seguido de grupos de quatro caracteres que empacotam três bytes de dados em vinte e quatro bits de índices de seis bits.

As linhas carregam no máximo quarenta e cinco bytes de dados, alinhadas ao orçamento de linha familiar do uuencode para que mensagens longas continuem legíveis em clientes de e-mail e visualizadores de log. O alfabeto em si é apenas mais, menos, dígitos de zero a nove, A–Z maiúsculas e a–z minúsculas—sem espaços nem pontuação que gateways EBCDIC costumavam reescrever. Strings vazias são válidas e ainda produzem um bloco bem formado com uma linha terminadora de comprimento zero.

Texto multilíngue, emoji e pontuação fazem ida e volta porque o caminho é UTF-8 completo, não um atalho Latin-1. A resposta sempre inclui result com o bloco xxencode completo, mode igual a encode, encoding igual a xxencode, bytes igual ao comprimento UTF-8 antes da codificação e filename ecoando o nome da linha begin para que você possa afirmar o tamanho da carga e os metadados de cabeçalho nos testes.

Entradas idênticas sempre produzem saídas idênticas porque o algoritmo é aritmética pura sem rede, sem sal aleatório e sem relógio de parede.

Decodificar xxencode de volta ao texto e tratar entrada inválida

Defina mode como decode e coloque em text um bloco xxencode clássico ou uma sequência de linhas apenas de corpo. Linhas em branco no início e no fim são ignoradas para que colagens multilinha ainda funcionem. Linhas begin opcionais no formato begin mode filename são analisadas para o filename informado, e uma linha end final é aceita quando presente; cargas sem invólucro são igualmente válidas desde que cada linha do corpo comece com um caractere de comprimento do alfabeto.

O alfabeto é estrito: apenas mais, menos, dígitos e letras são aceitos. Linhas que declaram mais de quarenta e cinco bytes de dados, grupos de quatro caracteres truncados mais curtos que o comprimento declarado ou dados após o terminador de comprimento zero são rejeitadas da mesma forma. A decodificação bem-sucedida devolve result como a string recuperada, mode decode, encoding xxencode, bytes como o comprimento UTF-8 decodificado e filename da linha begin ou data quando o cabeçalho foi omitido.

Prefira esta capacidade quando a intenção de busca for literalmente codificador xxencode, decodificador xxencode ou alternativa segura para EBCDIC ao uuencode para conteúdo legível; Base64, Ascii85 e uuencode clássico permanecem ferramentas separadas com suas próprias páginas.