probe: Document how to use ParsingMode

This commit is contained in:
Serial 2023-06-03 10:21:27 -04:00 committed by Alex
parent f8267641a9
commit bf80fec0dd

View file

@ -115,6 +115,20 @@ impl ParseOptions {
} }
/// The parsing strictness mode /// The parsing strictness mode
///
/// This can be set with [`Probe::options`].
///
/// # Examples
///
/// ```rust,no_run
/// use lofty::{ParseOptions, ParsingMode, Probe};
///
/// # fn main() -> lofty::Result<()> {
/// // 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()?;
/// # Ok(()) }
/// ```
#[derive(Copy, Clone, Debug, Ord, PartialOrd, Eq, PartialEq, Default)] #[derive(Copy, Clone, Debug, Ord, PartialOrd, Eq, PartialEq, Default)]
#[non_exhaustive] #[non_exhaustive]
pub enum ParsingMode { pub enum ParsingMode {