Enum lofty::ParsingMode

#[non_exhaustive]
pub enum ParsingMode {
    Strict,
    BestAttempt,
    Relaxed,
}

The parsing strictness mode

This can be set with Probe::options.

Examples

use lofty::{ParseOptions, ParsingMode, Probe};

// We only want to read spec-compliant inputs
let parsing_options = ParseOptions::new().parsing_mode(ParsingMode::Strict);
let tagged_file = Probe::open("foo.mp3")?.options(parsing_options).read()?;

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.

Strict

Will eagerly error on invalid input

This mode will eagerly error on any non spec-compliant input.

Examples of behavior

• Unable to decode text - The parser will error and the entire input is discarded
• Unable to determine the sample rate - The parser will error and the entire input is discarded

BestAttempt

Default mode, less eager to error on recoverably malformed input

This mode will attempt to fill in any holes where possible in otherwise valid, spec-compliant input.

NOTE: A readable input does not necessarily make it writeable.

Examples of behavior

• Unable to decode text - If valid otherwise, the field will be replaced by an empty string and the parser moves on
• Unable to determine the sample rate - The sample rate will be 0

Relaxed

Least eager to error, may produce invalid/partial output

This mode will discard any invalid fields, and ignore the majority of non-fatal errors.

If the input is malformed, the resulting tags may be incomplete, and the properties zeroed.

Examples of behavior

• Unable to decode text - The entire item is discarded and the parser moves on
• Unable to determine the sample rate - The sample rate will be 0

Trait Implementations

impl Clone for ParsingMode

fn clone(&self) -> ParsingMode

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for ParsingMode

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

Formats the value using the given formatter.

impl Default for ParsingMode

fn default() -> ParsingMode

Returns the “default value” for a type.

impl Ord for ParsingMode

fn cmp(&self, other: &ParsingMode) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized + PartialOrd,

Restrict a value to a certain interval.

impl PartialEq for ParsingMode

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

This method tests for self and other values to be equal, and is used by ==.

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

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

impl PartialOrd for ParsingMode

fn partial_cmp(&self, other: &ParsingMode) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

This method tests less than (for self and other) and is used by the < operator.

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

This method tests less than or equal to (for self and other) and is used by the <= operator.

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

This method tests greater than (for self and other) and is used by the > operator.

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

This method tests greater than or equal to (for self and other) and is used by the >= operator.

impl Copy for ParsingMode

impl Eq for ParsingMode

impl StructuralEq for ParsingMode

impl StructuralPartialEq for ParsingMode