Struct lofty::iff::wav::RIFFInfoList

pub struct RIFFInfoList { /* private fields */ }

A RIFF INFO LIST

Supported file types

• FileType::Wav

Conversions

To Tag

All items will be converted to a TagItem, with all unknown keys being stored with ItemKey::Unknown.

From Tag

When converting a TagItem, two conditions must be met:

• The TagItem has a value other than ItemValue::Binary
• It has a key that is 4 bytes in length and within the ASCII range

Implementations

impl RIFFInfoList

pub fn new() -> Self

Create a new empty RIFFInfoList

Examples

use lofty::iff::wav::RIFFInfoList;
use lofty::TagExt;

let riff_info_tag = RIFFInfoList::new();
assert!(riff_info_tag.is_empty());

pub fn get(&self, key: &str) -> Option<&str>

Get an item by key

pub fn insert(&mut self, key: String, value: String)

Insert an item

NOTE: This will do nothing if key is invalid

This will case-insensitively replace any item with the same key

pub fn remove(&mut self, key: &str) -> Option<String>

Remove an item by key

This will case-insensitively remove an item with the key, returning it if it exists.

Trait Implementations

impl Accessor for RIFFInfoList

fn artist(&self) -> Option<Cow<'_, str>>

Returns the artist

fn set_artist(&mut self, value: String)

Sets the artist

fn remove_artist(&mut self)

Removes the artist

fn title(&self) -> Option<Cow<'_, str>>

Returns the title

fn set_title(&mut self, value: String)

Sets the title

fn remove_title(&mut self)

Removes the title

fn album(&self) -> Option<Cow<'_, str>>

Returns the album

fn set_album(&mut self, value: String)

Sets the album

fn remove_album(&mut self)

Removes the album

fn genre(&self) -> Option<Cow<'_, str>>

Returns the genre

fn set_genre(&mut self, value: String)

Sets the genre

fn remove_genre(&mut self)

Removes the genre

fn comment(&self) -> Option<Cow<'_, str>>

Returns the comment

fn set_comment(&mut self, value: String)

Sets the comment

fn remove_comment(&mut self)

Removes the comment

fn track(&self) -> Option<u32>

Returns the track

fn set_track(&mut self, value: u32)

Sets the track

fn remove_track(&mut self)

Removes the track

fn track_total(&self) -> Option<u32>

Returns the track total

fn set_track_total(&mut self, value: u32)

Sets the track total

fn remove_track_total(&mut self)

Removes the track total

fn year(&self) -> Option<u32>

Returns the year

fn set_year(&mut self, value: u32)

Sets the year

fn remove_year(&mut self)

Removes the year

fn disk(&self) -> Option<u32>

Returns the disk

fn set_disk(&mut self, _value: u32)

Sets the disk

fn remove_disk(&mut self)

Removes the disk

fn disk_total(&self) -> Option<u32>

Returns the disk total

fn set_disk_total(&mut self, _value: u32)

Sets the disk total

fn remove_disk_total(&mut self)

Removes the disk total

impl Clone for RIFFInfoList

fn clone(&self) -> RIFFInfoList

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for RIFFInfoList

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

Formats the value using the given formatter.

impl Default for RIFFInfoList

fn default() -> RIFFInfoList

Returns the “default value” for a type.

impl From<RIFFInfoList> for Tag

fn from(input: RIFFInfoList) -> Self

Converts to this type from the input type.

impl From<Tag> for RIFFInfoList

fn from(input: Tag) -> Self

Converts to this type from the input type.

impl<'a> IntoIterator for &'a RIFFInfoList

type Item = &'a (String, String)

The type of the elements being iterated over.

type IntoIter = Iter<'a, (String, String)>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl IntoIterator for RIFFInfoList

type Item = (String, String)

The type of the elements being iterated over.

type IntoIter = IntoIter<<RIFFInfoList as IntoIterator>::Item>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl PartialEq for RIFFInfoList

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

type Remainder = SplitTagRemainder

The remainder of the split operation that is not represented in the resulting Tag.

fn split_tag(self) -> (Self::Remainder, Tag)

Extract and split generic contents into a Tag.

impl TagExt for RIFFInfoList

type Err = LoftyError

The associated error which can be returned from IO operations

type RefKey<'a> = &'a str

The type of key used in the tag for non-mutating functions

fn len(&self) -> usize

Returns the number of items in the tag

fn contains<'a>(&'a self, key: Self::RefKey<'a>) -> bool

Whether the tag contains an item with the key

fn is_empty(&self) -> bool

Whether the tag has any items

fn save_to(&self, file: &mut File) -> Result<(), Self::Err>

Save the tag to a File

fn dump_to<W: Write>(&self, writer: &mut W) -> Result<(), Self::Err>

Dump the tag to a writer

fn remove_from_path<P: AsRef<Path>>(&self, path: P) -> Result<(), Self::Err>

Remove a tag from a Path

fn remove_from(&self, file: &mut File) -> Result<(), Self::Err>

Remove a tag from a File

fn clear(&mut self)

Clear the tag, removing all items

fn save_to_path<P: AsRef<Path>>(&self, path: P) -> Result<(), Self::Err>

Save the tag to a path

impl Eq for RIFFInfoList

impl StructuralEq for RIFFInfoList

impl StructuralPartialEq for RIFFInfoList