Stringhe multiriga in YAML: | e >, spiegati con un'anteprima dal vivo

Stringhe multiriga in YAML

Stringhe multiriga in YAML: | vs >, e il chomping - e + | We.Inc

Scopri esattamente cosa producono gli stili a blocco | e > di YAML e gli indicatori di chomping -, clip e +. Scrivi il tuo testo e guarda la stringa risultante aggiornarsi dal vivo.

YAML scrive i testi lunghi con i block scalar. Una barra verticale (|) mantiene ogni a capo esattamente come l'hai scritto; un segno di maggiore (>) trasforma i singoli a capo in spazi. Un indicatore di chomping decide poi la fine: - rimuove l'ultimo a capo, senza indicatore ne resta uno, e + mantiene anche tutte le righe vuote finali.

Le sei intestazioni dei block scalar e cosa producono

Intestazione
A capo interni
Fine della stringa

Mantenuti
Un a capo

Mantenuti
Nessun a capo

Mantenuti
A capo più tutte le righe vuote finali

I singoli a capo diventano spazi
Un a capo

I singoli a capo diventano spazi
Nessun a capo

I singoli a capo diventano spazi
A capo più tutte le righe vuote finali

La riga di intestazione dopo la chiave è al massimo di due caratteri, eppure decide cosa riceve il tuo programma. Scegli uno stile e un indicatore di chomping nell'anteprima, scrivi del testo, e la stringa esatta compare sotto in notazione JSON così ogni a capo è visibile come \n.

Scrivi o incolla il testo da salvare. Ogni riga nella casella diventa una riga di contenuto del blocco.
Scegli literal (|) o folded (>), poi strip (-), clip (default) o keep (+).
Imposta quante righe vuote seguono il blocco per vedere cosa ne fa keep.
Copia lo YAML a sinistra. A destra c'è la stringa che un parser YAML 1.2 passa al tuo codice.

Usa |- per valori confrontati come stringhe esatte, come token o certificati incollati nella config, così non si infila nessun a capo di troppo.
Usa > per testi lunghi che nel programma devono risultare un unico paragrafo ma andare a capo in modo ordinato nel file.
Gli step shell nei file di CI di solito vogliono |, perché ogni comando deve restare sulla propria riga.
Indenta il contenuto più della chiave. La prima riga non vuota stabilisce l'indentazione per tutto il blocco.

Domande frequenti

Qual è la differenza tra | e > in YAML?

La barra verticale apre un blocco literal: ogni a capo che scrivi resta nel valore. Il segno di maggiore apre un blocco folded: un singolo a capo tra due righe normali diventa uno spazio, mentre le righe vuote diventano a capo.

Cosa significa il segno meno in |-?

È l'indicatore di chomping strip. L'ultimo a capo e le eventuali righe vuote dopo il testo vengono eliminati, quindi il valore termina all'ultimo carattere visibile.

Cosa fa + dopo | o >?

È l'indicatore keep. L'ultimo a capo e tutte le righe vuote finali diventano parte del valore. Senza indicatore, YAML fa clip: mantiene un solo a capo finale e scarta le righe vuote.

Perché alcune righe del mio blocco > non vengono unite?

Le righe che iniziano con un'indentazione extra sono righe più indentate. Il folding non le unisce mai, quindi gli a capo attorno a esse vengono preservati. Così puoi tenere un esempio di codice o un elenco dentro un testo folded.

Posso scrivere una stringa multiriga senza block scalar?

Sì. Una stringa tra virgolette doppie può contenere escape \n, e gli scalar tra virgolette o semplici possono proseguire su più righe, dove ogni singolo a capo diventa uno spazio. I block scalar sono più facili da leggere quando il testo si allunga.

Come funziona davvero il folding

Il folding unisce solo due righe vicine che iniziano entrambe all'indentazione propria del blocco. Un a capo tra di esse diventa uno spazio. Se lasci una riga vuota, il valore riceve invece un singolo a capo, ed è così che si scrivono i paragrafi.
Una riga che inizia con spazi in più viene lasciata com'è, e lo stesso vale per gli a capo su entrambi i lati. È la regola che applica l'anteprima, quindi prova a indentare una riga per vederlo succedere.

Indicatori di indentazione

Se la prima riga di contenuto deve iniziare con degli spazi, YAML non può indovinare l'indentazione. Aggiungi una cifra all'intestazione, come in |2, per indicare di quanti spazi è indentato il blocco rispetto al suo genitore.
La cifra e il segno di chomping si possono combinare in entrambi gli ordini, per esempio |2- o |-2.

Block scalar in file reali

Comandi shell in uno step di CI

Lo stile literal mantiene ogni comando sulla propria riga, che è ciò di cui ha bisogno la shell.

Una descrizione lunga unita in un solo paragrafo

Folded e strip: il valore è una sola riga di testo senza a capo alla fine.

Mantenere le righe vuote finali

Con + la riga vuota dopo il testo resta nel valore, quindi la stringa analizzata termina con due a capo.

Anteprima dei block scalar

Scrivi il testo, scegli uno stile e un indicatore di chomping, e vedi lo YAML che scriveresti accanto alla stringa esatta che restituisce un parser.

Testo da salvare

Stile del blocco

Literal |

Folded >

Indicatore di chomping

Strip -

Clip (default)

Keep +

Righe vuote dopo il blocco

YAML

Stringa risultante (notazione JSON)

{n} caratteri, {b} a capo

Grazie per il tuo ordine. Lo spediamo entro due giorni. Domande? Rispondi a questa email. Rif. ordine: 10442

Stringhe multiriga in YAML: | e >, spiegati con un'anteprima dal vivo