MP3::Ta...DDB_File(3)

✨ NAME ✨

okay so bestie, this is the MP3::Ta...DDB_File(3) manual page, hanging out in the User Contributed Perl Documentation area. The module is MP3::Tag::CDDB_File, and it is a module for parsing CDDB files. that's the whole name vibe 💖

---

🌸 SYNOPSIS 🌸

  my $db = MP3::Tag::CDDB_File->new($filename, $track); # Name of audio file
  my $db = MP3::Tag::CDDB_File->new_from($record, $track); # Contents of CDDB

  ($title, $artist, $album, $year, $comment, $track) = $db->parse();

also: see MP3::Tag — go peek at that one too, iykyk 🫶

---

💖 DESCRIPTION 💖

MP3::Tag::CDDB_File is designed to be called from the MP3::Tag module. It parses the content of a CDDB file. slay ✨

The file is found in the same directory as the audio file; the list of possible file names is taken from the field "cddb_files" if set by the MP3::Tag config() method. so like, check your config, bestie 🎀

---

parse() — main character energy 💅

($title, $artist, $album, $year, $comment, $track) =
   $db->parse($what);

parse_filename() extracts information about artist, title, track number, album and year from the CDDB record. $what is optional; it can be title, track, artist, album, year, genre or comment. If $what is defined, parse() will return only this element. 🦋

Additionally, $what can take values "artist_collection" (returns the value of artist in the disk-info field DTITLE, but only if author is specified in the track-info field TTITLE), "title_track" (returns the title specifically from track-info field — the "track" may fall back to the info from disk-info field), "comment_collection" (processed EXTD comment), "comment_track" (processed EXTT comment). 🔥

The returned year and genre is taken from DYEAR, DGENRE, EXTT, EXTD fields; recognized prefixes in the two last fields are YEAR, ID3Y, ID3G. The declarations of this form are stripped from the returned comment. 🌈

An alternative syntax "Recorded"/"Recorded on"/"Recorded in"/ is also supported; the format of the date recognized by ID3v2::year(), or just a date field without a prefix. ⭐

---

title() — the title track of this manpage 🎵

$title = $db->title();

Returns the title, obtained from the 'Tracktitle' entry of the file. cute. 💜

---

artist() — who's the main character? 👑

$artist = $db->artist();

Returns the artist name, obtained from the 'Performer' or 'Albumperformer' entries (the first which is present) of the file. slay. 💅

---

track() — number one? or number five? 🔢

$track = $db->track();

Returns the track number, stored during object creation, or queried from the parent. honestly flexible. 🦋

---

year() — time check ⏰

$year = $db->year();

Returns the year, obtained from the 'Year' entry of the file. (Often not present.) no cap, it ghosts sometimes. 🙈

---

album() — the whole era 💿

$album = $db->album();

Returns the album name, obtained from the 'Albumtitle' entry of the file. periodt. 🌸

---

comment() — the yapping field 💬

$comment = $db->comment();

Returns the 'Trackcomment' entry of the file. (Often not present.) lowkey same ghosting situation. 😭

---

genre() — vibe check 🎧

$genre = $db->genre($filename);

that's the exact signature, bestie — no extra prose in the original, so I'm not gonna invent any. 🫶

---

🫶 POD ERRORS 🫶

Hey! The above document had some coding errors, which are explained below:

Around line 36:

=over without closing =back

not me reading the POD errors 💀 but we keep it real.

---

with love from the perl v5.42.3 era, dated 2022-11-25, on the MP3::Ta...DDB_File(3) page — mwah 💋✨