GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages
CDDB::File(3) User Contributed Perl Documentation CDDB::File(3)

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

  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;
  }

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.

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

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

  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.

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

The (4-digit) year of release.

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.

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.

The run time of the CD in seconds.

The number of tracks on the CD.

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

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

  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.

http://www.freedb.org/

Tony Bowden

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

  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.
2005-10-04 perl v5.32.1

Search for    or go to Top of page |  Section 3 |  Main Index

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with ManDoc.