Auf visuelle Breite auffüllen

Eine Zeichenkette so aufzufüllen, dass Spalten im Terminal gerade stehen, ist ein Problem der visuellen Breite, nicht der Zeichenanzahl. Ostasiatische Ideogramme, Hangeul-Silben, lateinische Vollbreitbuchstaben und die meisten Emoji belegen in einer Festbreitenschrift zwei Spalten, während kombinierende Zeichen, Variationsselektoren und Verbinder der Breite null keine belegen. Ein Auffüllen nach JavaScript-Länge verschiebt jede Zelle, die Latein mit Japanisch, Chinesisch oder Koreanisch mischt. Dieses Werkzeug misst Anzeigespalten im Stil von East Asian Width und fügt ein einspaltiges Füllzeichen links, rechts oder beidseitig ein, bis die Zielspaltenzahl erreicht ist.

Wie die visuelle Spaltenbreite gemessen wird

In einem üblichen Monospace-Terminal belegt jeder ASCII-Buchstabe, jede Ziffer und jedes Satzzeichen eine Spalte. Dieses Denkmodell bricht, sobald die Zeichenkette ein Zeichen enthält, dessen East Asian Width Wide oder Fullwidth ist. Vereinheitlichte CJK-Ideogramme, Hangeul-Silben, Vollbreitziffern (die ideographischen Formen von null bis neun) und der lateinische Vollbreitblock belegen je zwei Spalten.

Kombinierende Zeichen der Kategorien Mn oder Me, Formatzeichen, mediale Vokale und finale Konsonanten der Hangeul-Jamo, Variationsselektoren und der Verbinder der Breite null belegen null Spalten und heften sich an das vorangehende Graphem. Regionalindikator-Paare, die ein Flaggen-Emoji bilden, gelten als ein einziger Zweispaltcluster, und mit einem Verbinder der Breite null verbundene Emoji bleiben ein Cluster der Breite zwei statt eines Stapels unabhängiger Piktogramme.

Zeichen mehrdeutiger Breite wie griechische Buchstaben und manche Symbole folgen der POSIX- und Westkonvention und zählen als eine Spalte, passend zu den meisten Linux- und macOS-Terminals außerhalb einer ostasiatischen Locale. Steuerzeichen einschließlich Tabulator und Zeilenumbruch werden abgelehnt: die Tabulatorbreite ist keine Eigenschaft der Zeichenkette, und dieses Werkzeug füllt eine Zelle, nicht eine ganze Tabelle. Der Algorithmus läuft über Unicode-Codepunkte, niemals über UTF-16-Surrogatpaare, sodass ein einzelnes Emoji außerhalb der Basic Multilingual Plane ein Zeichen ist, nicht zwei.

Das Ergebnis ist dieselbe Spaltenzahl, die eine vorsichtige Messung im Stil von wcwidth liefern würde — genau das, was Sie brauchen, bevor Füllzeichen ergänzt werden, damit ein japanischer Name und eine lateinische SKU eine gerade rechte Kante teilen.

Was Sie senden und was Sie zurückerhalten

Leerer Text ist erlaubt und erzeugt eine reine Füllzeichenkette der gewünschten Breite. Width ist die Zielanzahl visueller Spalten, eine nichtnegative ganze Zahl; die Aliasse target, columns, size und n greifen, wenn width fehlt. Side muss left, right oder both sein, mit den Aliassen start oder l, end oder r sowie center oder c.

Das optionale char ist ein einzelner Codepunkt, dessen eigene visuelle Breite genau eine Spalte ist, standardmäßig ein ASCII-Leerzeichen; ein Vollbreitleerzeichen oder ein Emoji als Füllung wird abgelehnt, weil eine zweispaltige Füllung ein ungerades Restbudget nicht treffen kann. Zahlen und boolesche Werte für text werden zu Dezimal- bzw. true/false-Zeichenketten gewandelt; Objekte und Arrays werden abgelehnt.

Klassische Prüfung: der zweizeichenige japanische Ortsname 東京 hat die visuelle Breite vier, daher ergibt rechtsseitiges Auffüllen auf width acht mit Leerzeichen 東京 plus vier Leerzeichen; linksseitiges Auffüllen von ASCII zweiundvierzig auf width sechs mit Null ergibt weiterhin 000042, wie gewöhnliches Pad bei rein lateinischer Eingabe.

Wo visuelles Auffüllen in der Praxis vorkommt

CLI-Autoren, Protokollformatierer und jeder, der eine Tabelle in Festbreitenschrift ausgibt, trifft dieses Problem, sobald ein japanischer, chinesischer oder koreanischer Wert in eine mit Zeichenkettenlänge bemessene Spalte fällt. Rechnungsnummern stehen neben Produktnamen; ein CJK-Name mit zwei JavaScript-Zeichen belegt vier Terminalspalten und schiebt die Preisspalte nach rechts. Markdown-Tabellen, Statusbretter in einem README und Thermobon-Drucker haben dieselbe Einschränkung, sobald eine Zelle Schriften mischt.

Datenpipelines, die festbreite Exportdateien für ostasiatische Märkte erzeugen, dürfen kein Auffüllen nach Zeichenanzahl verwenden, ohne das Layout zu zerbrechen, das der nachgelagerte Bank- oder Mainframe-Parser erwartet. Bevorzugen Sie diese Seite, wenn die Suchabsicht Auffüllen auf Monospace-Breite, visuelle Breite, East Asian Width, wcwidth oder das Ausrichten von CJK-Spalten im Terminal ist. Links- oder Nullauffüllen von ASCII-Kennungen ist eine andere Anfrage und gehört zum Werkzeug für das Auffüllen nach Zeichenanzahl; diese Seite gilt dem Spaltenausrichtungsproblem, das erst auftritt, wenn breite Zeichen in die Zelle gelangen.