Alinhar texto em colunas de largura fixa

Informe as linhas e o número esperado de colunas; o formatador mede o valor mais largo em cada posição e completa todos os campos até essa largura. O resultado traz larguras reutilizáveis, campos preenchidos e um texto multilinha pronto para exibição. Linhas inconsistentes são recusadas para evitar resultados ambíguos, tornando o recurso adequado para logs, relatórios de terminal, e-mails em texto simples e documentação.

Prepare as linhas com um contrato claro de colunas

Comece com uma lista de linhas, sendo cada linha uma lista de campos de texto. Defina column_count como a quantidade exata de campos que todas as linhas devem conter. A primeira linha pode ser um cabeçalho, mas isso não é obrigatório nem recebe tratamento especial: ela participa do cálculo como qualquer outro valor. Preserve o texto exatamente como você deseja exibi-lo, inclusive maiúsculas e espaços internos intencionais. Strings vazias são campos válidos e recebem preenchimento conforme a largura estabelecida pelos demais valores da coluna. A contagem explícita protege dados reunidos de fontes diferentes. Se uma linha tiver campos a mais ou a menos, a solicitação falha com um erro que identifica a linha e sua contagem real. Assim, um valor ausente não desloca silenciosamente os campos seguintes. Para uma saída previsível, normalize tabulações e quebras de linha dentro dos campos antes do envio.

Entenda a medição de largura e o preenchimento

O formatador examina cada coluna separadamente e registra a maior quantidade de caracteres encontrada naquela posição. Em seguida, acrescenta espaços comuns ao final de cada campo até atingir a largura registrada. Há também um espaço separador entre campos vizinhos. A largura é medida por pontos de código Unicode, e não por unidades UTF-16 do JavaScript, evitando a contagem dupla de caracteres suplementares comuns. O cálculo não faz suposições específicas de terminal sobre marcas combinantes, tabulações, emoji ou caracteres asiáticos largos, cuja aparência varia conforme fonte e renderizador. Letras, números e sinais comuns ficam alinhados de forma consistente em uma fonte monoespaçada. O último campo também recebe preenchimento, pois o contrato vale para todos os campos. A resposta fornece tanto as matrizes preenchidas quanto o texto unido, sem exigir que você interprete novamente as linhas formatadas.

Use o resultado em fluxos de texto confiáveis

Escolha a forma de saída adequada à próxima etapa. Use aligned_text quando você precisar de um bloco completo para terminal, bloco de código, relatório em texto simples ou mensagem monoespaçada. Use aligned_rows para acrescentar prefixos, bordas, recuos, cores ou outra apresentação sem perder o preenchimento calculado. A matriz column_widths ajuda outro sistema a formatar linhas adicionais nas mesmas dimensões. A transformação não remove espaços, ordena linhas, deduz cabeçalhos, trunca conteúdo nem altera maiúsculas. Essa contenção protege identificadores e dados com espaços significativos. Limites publicados para linhas, colunas e caracteres impedem consumo ilimitado de memória. Sem rede, aleatoriedade, relógio ou comparação dependente de localidade, a mesma entrada JSON sempre gera a mesma saída JSON. A automação por API custa US$ 0,002 por solicitação.