Cadenas multilínea en YAML: | y >, explicados con vista previa en vivo

Cadenas multilínea en YAML

Cadenas multilínea en YAML: | vs >, y el chomping - y + | We.Inc

Mira qué producen exactamente los estilos de bloque | y > de YAML y los indicadores de chomping -, clip y +. Escribe tu propio texto y observa cómo se actualiza la cadena resultante en vivo.

YAML escribe los textos largos con escalares de bloque. Una barra vertical (|) conserva cada salto de línea tal como lo escribiste; un signo mayor que (>) convierte los saltos de línea sencillos en espacios. Después, un indicador de chomping decide el final: - quita el salto de línea final, sin indicador se conserva uno, y + conserva además todas las líneas en blanco finales.

Las seis cabeceras de escalar de bloque y lo que producen

La línea de cabecera tras la clave tiene como mucho dos caracteres, y aun así decide lo que recibe tu programa. Elige un estilo y un indicador de chomping en la vista previa, escribe algo de texto, y la cadena exacta aparece abajo en notación JSON para que cada salto de línea se vea como \n.

Preguntas frecuentes

¿Qué diferencia hay entre | y > en YAML?

La barra vertical abre un bloque literal: cada salto de línea que escribes se queda en el valor. El signo mayor que abre un bloque folded: un salto sencillo entre dos líneas normales se convierte en un espacio, mientras que las líneas en blanco se convierten en saltos de línea.

¿Qué significa el signo menos en |-?

Es el indicador de chomping strip. Se eliminan el salto de línea final y las líneas en blanco posteriores al texto, así que el valor termina en el último carácter visible.

¿Qué hace + después de | o >?

Es el indicador keep. El salto de línea final y todas las líneas en blanco finales pasan a formar parte del valor. Sin ningún indicador, YAML aplica clip: conserva un salto de línea final y elimina las líneas en blanco.

¿Por qué algunas líneas no se pliegan en mi bloque >?

Las líneas que empiezan con sangría extra son líneas más sangradas. El plegado nunca las une, así que se conservan los saltos que las rodean. Esto te permite mantener un ejemplo de código o una lista dentro de un texto plegado.

¿Puedo escribir una cadena multilínea sin escalares de bloque?

Sí. Una cadena entre comillas dobles puede contener secuencias \n, y los escalares entre comillas o sin ellas pueden continuar en varias líneas, donde cada salto sencillo se pliega en un espacio. Los escalares de bloque son más fáciles de leer cuando el texto se alarga.

Cómo funciona realmente el plegado

Indicadores de sangría

Escalares de bloque en archivos reales

Comandos de shell en un paso de CI

El estilo literal mantiene cada comando en su propia línea, que es lo que necesita el shell.

Una descripción larga plegada en un solo párrafo

Folded y strip: el valor es una sola línea de texto sin salto de línea al final.

Conservar las líneas en blanco finales

Con + la línea en blanco tras el texto se queda en el valor, así que la cadena analizada termina con dos saltos de línea.

Vista previa de escalares de bloque

Escribe el texto, elige un estilo y un indicador de chomping, y mira el YAML que escribirías junto a la cadena exacta que devuelve un parser.

Texto para guardar

Estilo de bloque

Literal |

Folded >

Indicador de chomping

Strip -

Clip (por defecto)

Keep +

Líneas en blanco tras el bloque

YAML

Cadena resultante (notación JSON)

{n} caracteres, {b} saltos de línea

Gracias por tu pedido. Se envía en un plazo de dos días. ¿Dudas? Responde a este correo. Ref. del pedido: 10442

Empieza gratis · Sin tarjeta de crédito

Relacionado: Guías

Producto

Para quién es

Funciones

Recursos

Empresa

Mapa del sitio