Alinear texto en columnas de ancho fijo

Indique las filas y el número previsto de columnas; el formateador medirá el valor más ancho de cada posición y completará cada campo hasta esa anchura. El resultado incluye anchos reutilizables, campos rellenados y un bloque multilínea listo para mostrar. Las filas incoherentes se rechazan para evitar resultados ambiguos, por lo que esta función resulta útil en registros, informes de consola, correos de texto plano y documentación.

Prepare las filas con un contrato de columnas claro

Comience con una lista de filas, cada una formada por una lista de campos de texto. Establezca column_count con el número exacto de campos que debe contener cada fila. La primera fila puede ser una cabecera, pero no es obligatoria ni recibe un trato especial: interviene en el cálculo igual que los demás valores. Conserve el texto tal como desea mostrarlo, incluidas mayúsculas y espacios internos intencionados. Las cadenas vacías son campos válidos y se completan según la anchura determinada por otros valores de su columna. El recuento explícito protege cuando se combinan datos de distintas fuentes. Si una fila tiene campos de más o de menos, la solicitud devuelve un error que identifica la fila y el recuento real. Así, un valor ausente no desplaza silenciosamente los campos posteriores. Para obtener una salida previsible, normalice tabulaciones y saltos de línea dentro de los campos antes de enviarlos.

Comprenda cómo se miden y rellenan las columnas

El formateador examina cada columna por separado y registra la mayor cantidad de caracteres encontrada en esa posición. Después añade espacios normales al final de cada campo hasta alcanzar la anchura registrada. Entre campos contiguos se inserta además un espacio separador. La anchura se mide por puntos de código Unicode, no por unidades UTF-16 de JavaScript, para que los caracteres suplementarios habituales no se cuenten dos veces. El cálculo evita suposiciones propias de terminales sobre marcas combinadas, tabulaciones, emoji o caracteres asiáticos anchos, cuya representación depende de la fuente. Con letras, números y signos ordinarios en una fuente monoespaciada, las líneas quedan alineadas. También se rellena el último campo, ya que el contrato se aplica a todos los campos. La respuesta ofrece tanto las matrices rellenadas como el texto unido, sin obligar a analizar de nuevo las líneas formateadas.

Integre el resultado en flujos de texto fiables

Elija la salida adecuada para el siguiente paso. Use aligned_text si necesita un bloque completo para una consola, un bloque de código, un informe de texto plano o un mensaje con fuente monoespaciada. Use aligned_rows si desea añadir prefijos, bordes, sangrías o colores conservando el relleno calculado. La matriz column_widths permite que otro sistema formatee filas adicionales con las mismas dimensiones. La transformación no recorta valores, ordena filas, deduce cabeceras, trunca contenido ni cambia mayúsculas. Por ello es segura para identificadores y datos con espacios significativos. Los límites publicados de filas, columnas y caracteres evitan el consumo de memoria sin control. Como no hay red, azar, reloj ni comparaciones dependientes de la configuración regional, una misma entrada JSON produce siempre la misma salida JSON. La automatización mediante API cuesta $0.002 por solicitud.