Codificador EBCDIC

Cole texto simples e escolha to_ebcdic para receber bytes EBCDIC hexadecimais separados por espaços, ou cole hex e escolha to_ascii para recuperar caracteres legíveis. Estudantes, engenheiros de migração e equipes de suporte obtêm o mesmo JSON determinístico no executor gratuito do navegador e na API pré-paga.

Como ASCII e EBCDIC code page 037 se relacionam, e por que os não mapeados importam

Quando é maior, o caractere é omitido do fluxo de bytes e registrado em unmapped com o índice na string e code_point para que operadores possam remover ou transliterar de propósito. Tokens hex inválidos ou comprimento contínuo ímpar geram invalid_input em vez de inventar preenchimento.

Como chamar a API e o que a resposta contém

Envie um corpo JSON com o campo string obrigatório text (aliases input, value e data) e um mode opcional to_ebcdic ou to_ascii. O modo padrão é to_ebcdic: cada caractere mapeável vira um byte EBCDIC CP037 em hex minúsculo, unido com espaços em result e ebcdic_hex. O modo to_ascii trata text como hex EBCDIC—pares separados por espaços, vírgulas, ponto e vírgula, pipes, ou uma string contínua de zero a nove e A a F de comprimento par—e devolve a string recuperada em result e text. O comprimento da entrada é limitado a cem mil caracteres para que uma única requisição não esgote a memória do Worker. Em sucesso, ambos os modos incluem mode, code_page com a string 037, input, result, bytes como inteiros de zero a duzentos e cinquenta e cinco, byte_count, char_count, mapped_count, unmapped_count, unmapped como array de objetos com index, char e code_point, além de uma mensagem curta em inglês. A codificação também expõe ebcdic_hex igual a result; a decodificação normaliza ebcdic_hex para pares separados por espaços mesmo se você colou hex contínuo. Validação falha—text ausente, text não string, entrada grande demais, mode desconhecido, hex vazio, hex contínuo de comprimento ímpar ou token que não seja exatamente dois dígitos hexadecimais—retorna invalid_input e nunca é cobrada. O preço é fixo US$ 0,002 por requisição bem-sucedida com unidade item.

Dicas práticas, checagens de migração e ferramentas relacionadas

Checagens de ida e volta são o smoke test mais rápido: codifique Hello, confirme que o primeiro byte é C8 para H e que o espaço seria 40, depois decodifique o hex e confirme a string original. Esta ferramenta não é um conversor geral da família EBCDIC: as code pages 500, 1047 e 1140 diferem em símbolos de moeda e euro, então não assuma que o hex é portável entre esses CCSIDs. Prefira esta capacidade quando a intenção de busca for texto ASCII ou latino versus hex da IBM code page 037; use um codificador de bytes UTF-8 quando precisar de sequências multibyte modernas, e ferramentas Base64 quando o objetivo for enquadramento de transporte e não tradução de conjunto de caracteres. Ao ensinar, mostre a mesma letra como ASCII decimal, como hex CP037 e como a interpretação errada em ISO-8859-1 para que estudantes vejam por que integrações de mainframe ainda precisam de um passo EBCDIC explícito. Prefira to_ascii quando já copiou hex de um dump, um trace CICS ou um editor hex e quiser os glifos de volta. Inclua de propósito um emoji ou um caractere CJK ao lado de ASCII simples para afirmar que unmapped_count sobe e que o fluxo EBCDIC contém só o subconjunto mapeável—scripts de migração devem falhar fechado quando unmapped_count for diferente de zero se o sistema destino não puder armazenar esses caracteres. Mantenha payloads abaixo do limite de caracteres publicado; datasets binários de vários megabytes ficam offline com iconv ou utilitários de dataset. Tarefas com invalid_input não consomem saldo pré-pago, o que mantém scripts exploratórios baratos quando alunos colam grupos hex incompletos.