Enum TransformReason 

#[non_exhaustive]
pub enum TransformReason {
    EscapeSequence,
    LineFolding,
    MultiLineNormalization,
    BlockScalarProcessing,
    SingleQuoteEscape,
    InputNotBorrowable,
    ParserReturnedOwned,
}

The reason why a string value was transformed during parsing and cannot be borrowed.

When deserializing to &str, the value must exist verbatim in the input. However, certain YAML constructs require string transformation, making borrowing impossible.

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.

EscapeSequence

Escape sequences were processed (e.g., \n, \t, \uXXXX in double-quoted strings).

LineFolding

Line folding was applied (folded block scalar >).

MultiLineNormalization

Multi-line plain or quoted scalar with whitespace normalization.

BlockScalarProcessing

Block scalar processing (literal | or folded > with chomping/indentation).

SingleQuoteEscape

Single-quoted string with '' escape processing.

InputNotBorrowable

Borrowing is not supported because the deserializer does not have access to the full input buffer (for example, when deserializing from a Reader), or because the parser did not provide a slice that is a subslice of the original input.

ParserReturnedOwned

The parser returned an owned string for this scalar.

In newer saphyr-parser versions, zero-copy is represented directly as Cow::Borrowed. If a scalar comes through as Cow::Owned, the deserializer cannot safely fabricate a borrow, because it would not refer to the original input buffer.

Trait Implementations

impl Clone for TransformReason

fn clone(&self) -> TransformReason

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TransformReason

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

Formats the value using the given formatter.

impl Display for TransformReason

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

Formats the value using the given formatter.

impl PartialEq for TransformReason

fn eq(&self, other: &TransformReason) -> 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 Copy for TransformReason

impl Eq for TransformReason

impl StructuralPartialEq for TransformReason