NAME

       MP3::Tag::Cue - Module for parsing .cue files.

SYNOPSIS

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

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

       see MP3::Tag

DESCRIPTION

       MP3::Tag::Cue is designed to be called from the MP3::Tag module.

       It parses the content of a .cue file.

       The .cue file is looked for in the same directory as audio file; one of the following
       conditions must be satisfied:

       •   The "audio" file is specified is actually a .cue file;

       •   There is exactly one .cue file in the directory of audio file;

       •   There is exactly one .cue file in the directory of audio file with basename which is a
           beginning of the name of audio file.

       •   There is exactly one .cue file in the directory of audio file with basename which
           matches (case-insensitive) a beginning of the name of audio file.

       If no .cue file is found in the directory of audio file, the same process is repeated once
       one directory uplevel, with the name of the file's directory used instead of the file
       name.  E.g., with the files like this

          Foo/bar.cue
          Foo/bar/04.wav

       audio file Foo/bar/04.wav will be associated with Foo/bar.cue.

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

           parse_filename() extracts information about artist, title, track number, album and
           year from the .cue file.  $what is optional; it maybe 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 whole-disk-info field "PERFORMER", "songwriter".

       title()
            $title = $db->title();

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

       artist()
            $artist = $db->artist();

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

       track()
            $track = $db->track();

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

       year()
            $year = $db->year();

           Returns the year, obtained from the 'Year' entry of the file.  (Often not present.)

       album()
            $album = $db->album();

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

       comment()
            $comment = $db->comment();

           Returns the 'REM COMMENT' entry of the file.  (Often not present.)

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