Enum lofty::ItemKey

#[non_exhaustive]
pub enum ItemKey {
    AlbumTitle,
    SetSubtitle,
    ShowName,
    ContentGroup,
    TrackTitle,
    TrackSubtitle,
    OriginalAlbumTitle,
    OriginalArtist,
    OriginalLyricist,
    AlbumTitleSortOrder,
    AlbumArtistSortOrder,
    TrackTitleSortOrder,
    TrackArtistSortOrder,
    ShowNameSortOrder,
    ComposerSortOrder,
    AlbumArtist,
    TrackArtist,
    Arranger,
    Writer,
    Composer,
    Conductor,
    Director,
    Engineer,
    InvolvedPeople,
    Lyricist,
    MixDj,
    MixEngineer,
    MusicianCredits,
    Performer,
    Producer,
    Publisher,
    Label,
    InternetRadioStationName,
    InternetRadioStationOwner,
    Remixer,
    DiscNumber,
    DiscTotal,
    TrackNumber,
    TrackTotal,
    Popularimeter,
    ParentalAdvisory,
    RecordingDate,
    Year,
    OriginalReleaseDate,
    Isrc,
    Barcode,
    CatalogNumber,
    Work,
    Movement,
    MovementNumber,
    MovementTotal,
    MusicBrainzRecordingId,
    MusicBrainzTrackId,
    MusicBrainzReleaseId,
    MusicBrainzReleaseGroupId,
    MusicBrainzArtistId,
    MusicBrainzReleaseArtistId,
    MusicBrainzWorkId,
    FlagCompilation,
    FlagPodcast,
    FileType,
    FileOwner,
    TaggingTime,
    Length,
    OriginalFileName,
    OriginalMediaType,
    EncodedBy,
    EncoderSoftware,
    EncoderSettings,
    EncodingTime,
    ReplayGainAlbumGain,
    ReplayGainAlbumPeak,
    ReplayGainTrackGain,
    ReplayGainTrackPeak,
    AudioFileUrl,
    AudioSourceUrl,
    CommercialInformationUrl,
    CopyrightUrl,
    TrackArtistUrl,
    RadioStationUrl,
    PaymentUrl,
    PublisherUrl,
    Genre,
    InitialKey,
    Color,
    Mood,
    Bpm,
    CopyrightMessage,
    License,
    PodcastDescription,
    PodcastSeriesCategory,
    PodcastURL,
    PodcastReleaseDate,
    PodcastGlobalUniqueID,
    PodcastKeywords,
    Comment,
    Description,
    Language,
    Script,
    Lyrics,
    AppleXid,
    AppleId3v2ContentGroup,
    Unknown(String),
}

A generic representation of a tag’s key

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.

AlbumTitle

SetSubtitle

ShowName

ContentGroup

TrackTitle

TrackSubtitle

OriginalAlbumTitle

OriginalArtist

OriginalLyricist

AlbumTitleSortOrder

AlbumArtistSortOrder

TrackTitleSortOrder

TrackArtistSortOrder

ShowNameSortOrder

ComposerSortOrder

AlbumArtist

TrackArtist

Arranger

Writer

Composer

Conductor

Director

Engineer

InvolvedPeople

Lyricist

MixDj

MixEngineer

MusicianCredits

Performer

Producer

Publisher

Label

InternetRadioStationName

InternetRadioStationOwner

Remixer

DiscNumber

DiscTotal

TrackNumber

TrackTotal

Popularimeter

ParentalAdvisory

RecordingDate

Year

OriginalReleaseDate

Isrc

Barcode

CatalogNumber

Work

Movement

MovementNumber

MovementTotal

MusicBrainzRecordingId

MusicBrainz Recording ID

Textual representation of the UUID.

Reference: https://picard-docs.musicbrainz.org/en/appendices/tag_mapping.html#id21

MusicBrainzTrackId

MusicBrainz Track ID

Textual representation of the UUID.

Reference: https://picard-docs.musicbrainz.org/en/appendices/tag_mapping.html#id24

MusicBrainzReleaseId

MusicBrainz Release ID

Textual representation of the UUID.

Reference: https://picard-docs.musicbrainz.org/en/appendices/tag_mapping.html#id23

MusicBrainzReleaseGroupId

MusicBrainz Release Group ID

Textual representation of the UUID.

Reference: https://picard-docs.musicbrainz.org/en/appendices/tag_mapping.html#musicbrainz-release-group-id

MusicBrainzArtistId

MusicBrainz Artist ID

Textual representation of the UUID.

Reference: https://picard-docs.musicbrainz.org/en/appendices/tag_mapping.html#id17

MusicBrainzReleaseArtistId

MusicBrainz Release Artist ID

Textual representation of the UUID.

Reference: https://picard-docs.musicbrainz.org/en/appendices/tag_mapping.html#id22

MusicBrainzWorkId

MusicBrainz Work ID

Textual representation of the UUID.

Reference: https://picard-docs.musicbrainz.org/en/appendices/tag_mapping.html#musicbrainz-work-id

FlagCompilation

FlagPodcast

FileType

FileOwner

TaggingTime

Length

OriginalFileName

OriginalMediaType

EncodedBy

EncoderSoftware

EncoderSettings

EncodingTime

ReplayGainAlbumGain

ReplayGainAlbumPeak

ReplayGainTrackGain

ReplayGainTrackPeak

AudioFileUrl

AudioSourceUrl

CommercialInformationUrl

CopyrightUrl

TrackArtistUrl

RadioStationUrl

PaymentUrl

PublisherUrl

Genre

InitialKey

Color

Mood

Bpm

CopyrightMessage

License

PodcastDescription

PodcastSeriesCategory

PodcastURL

PodcastReleaseDate

PodcastGlobalUniqueID

PodcastKeywords

Comment

Description

Language

Script

Lyrics

AppleXid

AppleId3v2ContentGroup

Unknown(String)

When a key couldn’t be mapped to another variant

This will not allow writing keys that are out of spec (Eg. ID3v2.4 frame IDs must be 4 characters)

Implementations

impl ItemKey

pub fn from_key(tag_type: TagType, key: &str) -> Self

Map a format specific key to an ItemKey

NOTE: If used with ID3v2, this will only check against the ID3v2.4 keys. If you wish to use a V2 or V3 key, see upgrade_v2 and upgrade_v3

pub fn map_key(&self, tag_type: TagType, allow_unknown: bool) -> Option<&str>

Maps the variant to a format-specific key

Use allow_unknown to include ItemKey::Unknown. It is up to the caller to determine if the unknown key actually fits the format’s specifications.

Trait Implementations

impl Clone for ItemKey

fn clone(&self) -> ItemKey

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for ItemKey

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

Formats the value using the given formatter.

impl Hash for ItemKey

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for ItemKey

fn eq(&self, other: &ItemKey) -> 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<'a> TryFrom<&'a ItemKey> for AtomIdent<'a>

type Error = LoftyError

The type returned in the event of a conversion error.

fn try_from(value: &'a ItemKey) -> Result<Self, Self::Error>

Performs the conversion.

impl<'a> TryFrom<&'a ItemKey> for FrameId<'a>

type Error = LoftyError

The type returned in the event of a conversion error.

fn try_from(value: &'a ItemKey) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<ItemKey> for AtomIdent<'static>

type Error = LoftyError

The type returned in the event of a conversion error.

fn try_from(value: ItemKey) -> Result<Self, Self::Error>

Performs the conversion.

impl Eq for ItemKey

impl StructuralEq for ItemKey

impl StructuralPartialEq for ItemKey