Aligner du texte en colonnes à largeur fixe

Fournissez les lignes et le nombre de colonnes attendu : le formateur mesure la valeur la plus large à chaque position, puis complète chaque champ jusqu’à cette largeur. Le résultat comprend les largeurs réutilisables, les champs complétés et un bloc multiligne prêt à afficher. Les lignes incohérentes sont refusées afin d’éviter toute sortie ambiguë, ce qui convient aux journaux, rapports en ligne de commande, courriels en texte brut et documents.

Préparez les lignes avec un contrat de colonnes précis

Commencez par une liste de lignes, chacune étant une liste de champs textuels. Définissez column_count sur le nombre exact de champs que chaque ligne doit contenir. La première ligne peut servir d’en-tête, mais ce n’est ni obligatoire ni traité spécialement : elle participe au calcul comme toute autre valeur. Conservez le texte exactement comme vous souhaitez l’afficher, y compris les majuscules et les espaces internes voulus. Une chaîne vide reste un champ valide et reçoit le complément déterminé par les autres valeurs de sa colonne. Le décompte explicite protège les assemblages provenant de plusieurs sources. Si une ligne contient trop ou trop peu de champs, la requête échoue avec une erreur qui indique la ligne et son nombre réel de champs. Une valeur manquante ne peut donc pas décaler silencieusement les suivantes. Pour un résultat prévisible, normalisez les tabulations et retours à la ligne présents dans les champs avant l’envoi.

Comprenez la mesure et le remplissage des largeurs

Le formateur étudie chaque colonne séparément et mémorise le plus grand nombre de caractères rencontré à cette position. Il ajoute ensuite des espaces ordinaires à la fin de chaque champ jusqu’à la largeur enregistrée, plus un espace séparateur entre deux champs voisins. La mesure repose sur les points de code Unicode plutôt que sur les unités UTF-16 de JavaScript, afin de ne pas compter deux fois certains caractères supplémentaires. Le calcul n’invente aucune règle propre aux terminaux pour les signes combinés, tabulations, emoji ou caractères asiatiques larges, dont l’affichage dépend de la police. Avec des lettres, nombres et signes courants dans une police à chasse fixe, les lignes restent alignées. Le dernier champ est également complété, car le contrat concerne tous les champs. La réponse livre à la fois les tableaux complétés et le texte assemblé, sans vous obliger à analyser de nouveau les lignes formatées.

Exploitez le résultat dans des flux de texte fiables

Choisissez la représentation adaptée à l’étape suivante. Utilisez aligned_text pour obtenir un bloc complet destiné à une console, un bloc de code, un rapport en texte brut ou un message à chasse fixe. Préférez aligned_rows si vous souhaitez ajouter préfixes, bordures, retraits ou couleurs tout en conservant le remplissage calculé. Le tableau column_widths permet à un autre système de présenter des lignes supplémentaires selon les mêmes dimensions. La transformation ne supprime aucun espace, ne trie pas les lignes, ne devine pas d’en-tête, ne tronque rien et ne change pas la casse. Elle préserve donc les identifiants et les données où les espaces comptent. Les limites publiées empêchent une consommation de mémoire illimitée. Sans réseau, hasard, horloge ni comparaison régionale, une entrée JSON identique produit toujours la même sortie JSON. L’automatisation par API coûte $0.002 par requête.