Enum MultilineStyle 

#[non_exhaustive]
pub enum MultilineStyle {
    Floating,
    Bold,
    BoldFloating,
    Transparent,
    Light,
    FoldingQuotes,
}

Controls which multiline string format is preferred when rendering strings with newlines.

Only affects strings that contain at least one EOL (LF or CRLF). Single-line strings always follow the normal bare_strings / string_quoted_fold_style options.

• Bold (``, default): double backtick, body always at col 2. Always safe.
• Floating (`): single backtick, body at n+2. Falls back to Bold when any content line would overflow wrap_width at that indent, or when the string exceeds multiline_max_lines, or when content is pipe-heavy / backtick-starting.
• BoldFloating (``): double backtick, body at n+2 when it fits, col 2 when it overflows.
• Transparent (```): triple backtick, body at col 0. Falls back to Bold when content is pipe-heavy or has backtick-starting lines (visually unsafe in that format).
• Light (` or ``): prefers `; falls back to `` like Floating, but the fallback reason differs — see variant doc for details.
• FoldingQuotes (JSON string with / folds): never uses any multiline string format. Renders EOL-containing strings as folded JSON strings. When the encoded string is within 25 % of wrap_width from fitting, it is emitted unfolded (overrunning the limit is preferred over a fold that saves almost nothing).

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Floating

` with body at n+2; falls back to Bold on overflow or excessive length.

Bold

`` with body always at col 2.

BoldFloating

`` with body at n+2 when it fits, col 2 when any line overflows wrap_width.

Transparent

``` with body at col 0; falls back to Bold when content is pipe-heavy or starts with backtick characters. string_multiline_fold_style has no effect here — / continuations are not allowed inside triple-backtick blocks.

Light

` preferred; falls back to `` only when content looks like TJSON markers (pipe-heavy or backtick-starting lines). Width overflow and line count do NOT trigger fallback — a long ` is preferred over the heavier `` format.

FoldingQuotes

Always a JSON string for EOL-containing strings; folds with / to fit wrap_width unless the overrun is within 25 % of wrap_width.

Trait Implementations

impl Clone for MultilineStyle

fn clone(&self) -> MultilineStyle

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for MultilineStyle

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for MultilineStyle

fn default() -> MultilineStyle

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for MultilineStyle

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl FromStr for MultilineStyle

type Err = String

The associated error which can be returned from parsing.

fn from_str(input: &str) -> Result<Self, Self::Err>

Parses a string s to return a value of this type.

impl PartialEq for MultilineStyle

fn eq(&self, other: &MultilineStyle) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for MultilineStyle

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Copy for MultilineStyle

impl Eq for MultilineStyle

impl StructuralPartialEq for MultilineStyle