oracular (3) CDDB::File.3pm.gz

NAME

       CDDB::File - Parse a CDDB/freedb data file

SYNOPSIS

         my $disc = CDDB::File->new("rock/f4109511");

         print $disc->id, $disc->all_ids;
         print $disc->artist, $disc->title;
         print $disc->year, $disc->genre, $disc->extd;
         print $disc->length, $disc->track_count;

         print $disc->revision, $disc->submitted_via, $disc->processed_by;

         foreach my $track ($disc->tracks) {
           print $track->number, $track->title, $track->artist;
           print $track->length, $track->extd;
         }

DESCRIPTION

       This module provides an interface for extracting data from CDDB-format data files, as used by freedb.

       It does not read data from your CD, or submit information to freedb.

METHODS

   new
         my $disc = CDDB::File->new("rock/f4109511");

       This will create a new object representing the data in the file name specified.

   id / all_ids
         my $discid = $disc->id;
         my @discid = $disc->all_ids;

       Due to how freedb works, one CD may have several IDs associated with it. 'id' will return the first of
       these (not necessarily related to the filename from which this was read), whilst 'all_ids' will return
       all of them.

   title / artist
       The title and artist of this CD. For eponymous CDs these will be identical, even if the data file leaves
       the artist field blank.

   year
       The (4-digit) year of release.

   genre
       The genre of this CD. This is the genre as stored in the data file itself, which is not related to the 11
       main freedb genres.

   extd
       The "extended data" for the CD. This is used for storing miscellaneous information which has no better
       storage place, and can be of any length.

   length
       The run time of the CD in seconds.

   track_count
       The number of tracks on the CD.

   revision
       Each time information regarding the CD is updated this revision number is incremented. This returns the
       revision number of this version.

   processed_by / submitted_via
       The software which submitted this information to freedb and which processed it at the other end.

   tracks
         foreach my $track ($disc->tracks) {
           print $track->number, $track->title, $track->artist;
           print $track->length, $track->extd;
         }

       Returns a list of Track objects, each of which knows its number (numering from 1), title, length (in
       seconds), offset, and may also have extended track data.

       Tracks may also contain an 'artist' field. If this is not set the artist method will return the artist of
       the CD.

SEE ALSO

       http://www.freedb.org/

AUTHOR

       Tony Bowden

BUGS and QUERIES

       Please direct all correspondence regarding this module to:
         bug-CDDB-File@rt.cpan.org

COPYRIGHT

         Copyright (C) 2001-2005 Tony Bowden. All rights reserved.

         This program is free software; you can redistribute it and/or modify it under
         the terms of the GNU General Public License; either version 2 of the License,
         or (at your option) any later version.

         This program is distributed in the hope that it will be useful, but WITHOUT
         ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
         FOR A PARTICULAR PURPOSE.