Riempire alla larghezza visiva

Riempire una stringa perché le colonne restino allineate in un terminale è un problema di larghezza visiva, non di conteggio dei caratteri. Ideogrammi dell'Asia orientale, sillabe hangul, lettere latine a larghezza piena e la maggior parte degli emoji occupano due colonne in un carattere monospazio, mentre i segni combinanti, i selettori di variazione e i joiner a larghezza zero non ne occupano alcuna. Un riempimento basato sulla lunghezza JavaScript disallinea qualsiasi cella che mescoli latino e giapponese, cinese o coreano. Questo strumento misura le colonne di visualizzazione nello stile East Asian Width e inserisce un carattere di riempimento di una colonna a sinistra, a destra o su entrambi i lati finché non si raggiunge il numero di colonne obiettivo.

Come si misura la larghezza visiva di colonna

In un terminale monospazio tipico ogni lettera, cifra e segno di punteggiatura ASCII occupa una colonna. Quel modello mentale si spezza non appena la stringa contiene un carattere il cui East Asian Width è Wide o Fullwidth. Ideogrammi unificati CJK, sillabe hangul, cifre a larghezza piena (le forme ideografiche da zero a nove) e il blocco latino a larghezza piena occupano ciascuno due colonne.

I segni combinanti delle categorie Mn o Me, i caratteri di formato, le vocali mediali e le consonanti finali jamo dell'hangul, i selettori di variazione e il joiner a larghezza zero occupano zero colonne e si attaccano al grafema precedente. Le coppie di indicatori regionali che formano un emoji bandiera sono trattate come un unico cluster di due colonne, e gli emoji uniti con un joiner a larghezza zero restano un cluster di larghezza due anziché una pila di pittogrammi indipendenti.

I caratteri a larghezza ambigua, come le lettere greche e alcuni simboli, seguono la convenzione POSIX e occidentale e contano come una colonna, il che coincide con la maggior parte dei terminali Linux e macOS fuori da una localizzazione dell'Asia orientale. I caratteri di controllo, tabulazione e a capo compresi, sono rifiutati: la larghezza del tab non è una proprietà della stringa, e questo strumento riempie una cella, non un'intera tabella.

L'algoritmo percorre i punti di codice Unicode, mai le coppie surrogato UTF-16, così un singolo emoji fuori dal Basic Multilingual Plane è un carattere, non due. Il risultato è lo stesso conteggio di colonne che Lei otterrebbe da una misura prudente in stile wcwidth, esattamente ciò che serve prima di aggiungere caratteri di riempimento perché un nome giapponese e uno SKU latino condividano un bordo destro dritto.

Dove il riempimento a larghezza visiva compare nel lavoro reale

Gli autori di CLI, i formattatori di registri e chiunque stampi una tabella in carattere monospazio incontrano questo problema la prima volta che un valore giapponese, cinese o coreano cade in una colonna dimensionata con la lunghezza della stringa. I numeri di fattura stanno accanto ai nomi di prodotto; un nome CJK di due caratteri JavaScript occupa quattro colonne di terminale e spinge la colonna del prezzo a destra.

Le tabelle Markdown, i pannelli di stato di un README e le stampanti termiche di scontrini hanno lo stesso vincolo quando una cella mescola scritture. Le pipeline di dati che emettono file di esportazione a larghezza fissa per i mercati dell'Asia orientale non possono usare un riempimento per conteggio di caratteri senza rompere il layout che si aspetta il parser bancario o mainframe a valle. Preferisca questa pagina quando l'intento di ricerca è riempire alla larghezza monospazio, larghezza visiva, East Asian Width, wcwidth o allineare colonne CJK in un terminale.

Il pad a sinistra o con zeri di identificatori ASCII è un'altra query e appartiene allo strumento di pad per conteggio di caratteri; questa pagina affronta il problema di allineamento delle colonne che compare solo quando caratteri larghi entrano nella cella.