Struct lofty::id3::v1::Id3v1Tag

pub struct Id3v1Tag {
    pub title: Option<String>,
    pub artist: Option<String>,
    pub album: Option<String>,
    pub year: Option<String>,
    pub comment: Option<String>,
    pub track_number: Option<u8>,
    pub genre: Option<u8>,
}

An ID3v1 tag

ID3v1 is a severely limited format, with each field being incredibly small in size. All fields have been commented with their maximum sizes and any other additional restrictions.

Attempting to write a field greater than the maximum size will not error, it will just be shrunk.

Conversions

From Tag

Two checks are performed when converting a genre:

• GENRES contains the string
• The ItemValue can be parsed into a u8

Fields

title: Option<String>

Track title, 30 bytes max

artist: Option<String>

Track artist, 30 bytes max

album: Option<String>

Album title, 30 bytes max

year: Option<String>

Release year, 4 bytes max

comment: Option<String>

A short comment

The number of bytes differs between versions, but not much. A V1 tag may have been read, which limits this field to 30 bytes. A V1.1 tag, however, only has 28 bytes available.

Lofty will always write a V1.1 tag.

track_number: Option<u8>

The track number, 1 byte max

Issues:

• The track number cannot be 0. Many readers, including Lofty, look for a null byte at the end of the comment to differentiate between V1 and V1.1.
• A V1 tag may have been read, which does not have a track number.

genre: Option<u8>

The track’s genre, 1 byte max

ID3v1 has a predefined set of genres, see GENRES. This byte should be an index to a genre.

Trait Implementations

impl Accessor for Id3v1Tag

fn title(&self) -> Option<&str>

Returns the title

fn set_title(&mut self, value: String)

Sets the title

fn remove_title(&mut self)

Removes the title

fn artist(&self) -> Option<&str>

Returns the artist

fn set_artist(&mut self, value: String)

Sets the artist

fn remove_artist(&mut self)

Removes the artist

fn album(&self) -> Option<&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<&str>

Returns the genre

fn set_genre(&mut self, genre: String)

Sets the genre

fn remove_genre(&mut self)

Removes the genre

impl Clone for Id3v1Tag

fn clone(&self) -> Id3v1Tag

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Id3v1Tag

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

Formats the value using the given formatter.

impl Default for Id3v1Tag

fn default() -> Id3v1Tag

Returns the “default value” for a type.

impl From<Id3v1Tag> for Tag

fn from(input: Id3v1Tag) -> Self

Performs the conversion.

impl From<Tag> for Id3v1Tag

fn from(input: Tag) -> Self

Performs the conversion.

impl PartialEq<Id3v1Tag> for Id3v1Tag

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

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

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

This method tests for !=.

impl TagExt for Id3v1Tag

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

Dumps the tag to a writer

Errors

• std::io::Error

type Err = LoftyError

The associated error which can be returned from IO operations

fn is_empty(&self) -> bool

Whether the tag has any items

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

Save the tag to a path

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

Save the tag to a File

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

impl StructuralPartialEq for Id3v1Tag