Struct audiotags::Tag

pub struct Tag { /* fields omitted */ }

A builder for Box<dyn AudioTag>. If you do not want a trait object, you can use individual types.

Examples

use audiotags::{Tag, TagType};
// Guess the format by default
let mut tag = Tag::new().read_from_path("assets/a.mp3").unwrap();
tag.set_title("Foo");
// you can convert the tag type and save the metadata to another file.
tag.to_dyn_tag(TagType::Mp4).write_to_path("assets/a.m4a");
// you can specify the tag type (but when you want to do this, also consider directly using the concrete type)
let tag = Tag::new().with_tag_type(TagType::Mp4).read_from_path("assets/a.m4a").unwrap();
assert_eq!(tag.title(), Some("Foo"));

Implementations

impl Tag

pub fn new() -> Self

Initiate a new Tag (a builder for Box<dyn AudioTag>) with default configurations. You can then optionally chain with_tag_type and/or with_config. Finally, you read_from_path

pub fn with_tag_type(self, tag_type: TagType) -> Self

Specify the tag type

pub fn with_config(self, config: Config) -> Self

Specify configuration, if you do not want to use the default

pub fn read_from_path(
    &self,
    path: impl AsRef<Path>
) -> Result<Box<dyn AudioTag>>

Trait Implementations

impl Default for Tag

fn default() -> Tag

Returns the "default value" for a type.