Remplir à la chasse fixe

Remplir une chaîne pour que les colonnes s'alignent dans un terminal est un problème de largeur visuelle, pas de décompte de caractères. Les idéogrammes d'Asie de l'Est, les syllabes hangul, les lettres latines pleine chasse et la plupart des emoji occupent deux colonnes dans une police à chasse fixe, tandis que les marques combinantes, les sélecteurs de variation et les ligateurs de largeur nulle n'en occupent aucune. Un remplissage fondé sur la longueur JavaScript désaligne toute cellule qui mélange latin et japonais, chinois ou coréen. Cet outil mesure les colonnes d'affichage à la manière East Asian Width, puis insère un caractère de remplissage d'une colonne à gauche, à droite ou des deux côtés jusqu'à atteindre le nombre de colonnes cible.

Comment la largeur visuelle d'une colonne est mesurée

Dans un terminal à chasse fixe habituel, chaque lettre, chiffre et signe de ponctuation ASCII occupe une colonne. Ce modèle mental se brise dès que la chaîne contient un caractère dont l'East Asian Width est Wide ou Fullwidth. Les idéogrammes unifiés CJK, les syllabes hangul, les chiffres pleine chasse (formes idéographiques de zéro à neuf) et le bloc latin pleine chasse occupent chacun deux colonnes.

Les marques combinantes des catégories Mn ou Me, les caractères de format, les voyelles médianes et consonnes finales jamo du hangul, les sélecteurs de variation et le ligateur de largeur nulle occupent zéro colonne et s'attachent au graphème précédent. Les paires d'indicateurs régionaux qui forment un emoji drapeau sont traitées comme une grappe unique de deux colonnes, et les emoji joints par un ligateur de largeur nulle restent une grappe de largeur deux plutôt qu'une pile de pictogrammes indépendants.

Les caractères de largeur ambiguë, comme les lettres grecques et certains symboles, suivent la convention POSIX et occidentale et comptent pour une colonne, ce qui correspond à la plupart des terminaux Linux et macOS hors locale d'Asie de l'Est. Les caractères de contrôle, y compris tabulation et saut de ligne, sont rejetés : la largeur de tabulation n'est pas une propriété de la chaîne, et cet outil remplit une cellule, pas un tableau entier.

L'algorithme parcourt les points de code Unicode, jamais les paires de substitution UTF-16, donc un emoji hors du Basic Multilingual Plane est un caractère, pas deux. Le résultat est le même nombre de colonnes qu'une mesure prudente de type wcwidth, exactement ce qu'il vous faut avant d'ajouter des caractères de remplissage pour qu'un nom japonais et un SKU latin partagent un bord droit net.

Où le remplissage à largeur visuelle intervient dans le travail réel

Les auteurs de CLI, les formateurs de journaux et quiconque imprime un tableau en police à chasse fixe rencontrent ce problème dès qu'une valeur japonaise, chinoise ou coréenne tombe dans une colonne dimensionnée avec la longueur de chaîne. Les numéros de facture côtoient des noms de produits ; un nom CJK de deux caractères JavaScript occupe quatre colonnes de terminal et pousse la colonne de prix vers la droite.

Les tableaux Markdown, les tableaux de bord d'un README et les imprimantes thermiques de reçus ont la même contrainte dès qu'une cellule mélange les écritures. Les pipelines de données qui émettent des fichiers d'export à largeur fixe pour les marchés d'Asie de l'Est ne peuvent pas utiliser un remplissage par décompte de caractères sans casser la mise en page qu'attend l'analyseur bancaire ou mainframe en aval.

Préférez cette page lorsque l'intention de recherche est remplir à la largeur à chasse fixe, largeur visuelle, East Asian Width, wcwidth ou aligner des colonnes CJK dans un terminal. Le pad à gauche ou par zéros d'identifiants ASCII est une autre requête et relève de l'outil de pad par décompte de caractères ; cette page traite le problème d'alignement de colonnes qui n'apparaît que lorsque des caractères larges entrent dans la cellule.