Wieloliniowe stringi w YAML: | i > wyjaśnione z podglądem na żywo

Wieloliniowe stringi w YAML

Wieloliniowe stringi w YAML: | vs > oraz chomping - i + | We.Inc

Zobacz dokładnie, co dają style blokowe | i > w YAML oraz wskaźniki chomping -, clip i +. Wpisz własny tekst i obserwuj, jak wynikowy string zmienia się na żywo.

YAML zapisuje długi tekst za pomocą skalarów blokowych. Pionowa kreska (|) zachowuje każde złamanie linii dokładnie tak, jak zostało wpisane; znak większości (>) zamienia pojedyncze złamania linii na spacje. Wskaźnik chomping decyduje następnie o zakończeniu: - usuwa końcowy znak nowej linii, brak wskaźnika zostawia jeden, a + zachowuje dodatkowo wszystkie końcowe puste linie.

Sześć nagłówków skalarów blokowych i co dają

  • Nagłówek
  • Złamania linii w środku
  • Koniec stringa
  • Zachowane
  • Jeden znak nowej linii
  • Zachowane
  • Bez znaku nowej linii
  • Zachowane
  • Znak nowej linii plus wszystkie końcowe puste linie
  • Pojedyncze złamania stają się spacjami
  • Jeden znak nowej linii
  • Pojedyncze złamania stają się spacjami
  • Bez znaku nowej linii
  • Pojedyncze złamania stają się spacjami
  • Znak nowej linii plus wszystkie końcowe puste linie

Linia nagłówka po kluczu ma najwyżej dwa znaki, a jednak decyduje o tym, co otrzyma Twój program. Wybierz styl i wskaźnik chomping w podglądzie, wpisz tekst, a dokładny string pojawi się poniżej w notacji JSON, dzięki czemu każdy znak nowej linii jest widoczny jako \n.

  • Wpisz lub wklej tekst, który chcesz zapisać. Każda linia w polu staje się jedną linią treści bloku.
  • Wybierz literal (|) lub folded (>), a potem strip (-), clip (domyślnie) lub keep (+).
  • Ustaw, ile pustych linii następuje po bloku, aby zobaczyć, co robi z nimi keep.
  • Skopiuj YAML po lewej. Po prawej jest string, który parser YAML 1.2 przekazuje do Twojego kodu.
  • Używaj |- dla wartości porównywanych jako dokładne stringi, takich jak tokeny lub certyfikaty wklejane do konfiguracji, aby nie wkradł się zbędny znak nowej linii.
  • Używaj > dla długiej prozy, która w programie ma być jednym akapitem, ale w pliku ładnie się zawijać.
  • Kroki powłoki w plikach CI zwykle wymagają |, bo każde polecenie musi pozostać w osobnej linii.
  • Wcinaj treść głębiej niż klucz. Pierwsza niepusta linia ustala wcięcie dla całego bloku.

Najczęściej zadawane pytania

Jaka jest różnica między | a > w YAML?

Pionowa kreska rozpoczyna blok literalny: każde wpisane złamanie linii pozostaje w wartości. Znak większości rozpoczyna blok zwijany: pojedyncze złamanie między dwiema zwykłymi liniami zamienia się w spację, a puste linie stają się znakami nowej linii.

Co oznacza minus w |-?

To wskaźnik chomping strip. Końcowe złamanie linii i wszystkie puste linie po tekście są usuwane, więc wartość kończy się na ostatnim widocznym znaku.

Co robi + po | lub >?

To wskaźnik keep. Końcowe złamanie linii i każda końcowa pusta linia stają się częścią wartości. Bez żadnego wskaźnika YAML stosuje clip: zachowuje jeden końcowy znak nowej linii i usuwa puste linie.

Dlaczego niektóre linie w moim bloku > nie są zwijane?

Linie zaczynające się od dodatkowego wcięcia to linie bardziej wcięte. Zwijanie nigdy ich nie łączy, więc złamania wokół nich są zachowane. Dzięki temu możesz trzymać przykład kodu lub listę wewnątrz zwijanej prozy.

Czy mogę napisać wieloliniowy string bez skalarów blokowych?

Tak. String w podwójnych cudzysłowach może zawierać sekwencje \n, a skalary w cudzysłowach lub zwykłe mogą ciągnąć się przez kilka linii, przy czym każde pojedyncze złamanie zamienia się w spację. Gdy tekst robi się długi, skalary blokowe łatwiej czytać.

Jak naprawdę działa zwijanie

  • Zwijanie łączy tylko dwie sąsiednie linie, które obie zaczynają się na poziomie wcięcia bloku. Jedno złamanie między nimi staje się spacją. Jeśli zostawisz jedną pustą linię, wartość dostaje zamiast tego jeden znak nowej linii i tak właśnie zapisuje się akapity.
  • Linia zaczynająca się od dodatkowych spacji zostaje bez zmian, podobnie jak złamania po obu jej stronach. Tę właśnie regułę stosuje podgląd, więc spróbuj wciąć jedną linię i zobacz, co się stanie.

Wskaźniki wcięcia

  • Jeśli pierwsza linia treści musi zaczynać się od spacji, YAML nie zgadnie wcięcia. Dodaj cyfrę do nagłówka, na przykład |2, aby określić, o ile spacji blok jest wcięty względem rodzica.
  • Cyfrę i znak chomping można łączyć w dowolnej kolejności, na przykład |2- lub |-2.

Skalary blokowe w prawdziwych plikach

Polecenia powłoki w kroku CI

Styl literalny zachowuje każde polecenie w osobnej linii, czego potrzebuje powłoka.

Długi opis zwinięty w jeden akapit

Zwinięty i obcięty: wartość to jedna linia tekstu bez znaku nowej linii na końcu.

Zachowanie końcowych pustych linii

Z + pusta linia po tekście pozostaje w wartości, więc sparsowany string kończy się dwoma znakami nowej linii.

Podgląd skalara blokowego

Wpisz tekst, wybierz styl i wskaźnik chomping, a zobaczysz YAML, który byś napisał, obok dokładnego stringa zwracanego przez parser.

Tekst do zapisania

Styl bloku

Literal |

Folded >

Wskaźnik chomping

Strip -

Clip (domyślnie)

Keep +

Puste linie po bloku

YAML

Wynikowy string (notacja JSON)

Znaki: {n}, złamania linii: {b}

Dziękujemy za zamówienie. Wysyłka w ciągu dwóch dni. Pytania? Odpowiedz na tego e-maila. Nr zamówienia: 10442

Zacznij za darmo · Bez karty kredytowej

Powiązane: Poradniki

Produkt

Dla kogo

Funkcje

Zasoby

Firma

Mapa strony