ID3_GET_TAG(3) 1 ID3_GET_TAG(3)id3_get_tag - Get all information stored in an ID3 tagSYNOPSIS
array id3_get_tag (string $filename, [int $version = ID3_BEST])
DESCRIPTION id3_get_tag(3) is used to get all information stored in the id3 tag of the specified file.
PARAMETERS
o $filename
- The path to the MP3 file Instead of a filename you may also pass a valid stream resource
o $version
- Allows you to specify the version of the tag as MP3 files may contain both, version 1.x and version 2.x tags Since version 0.2
id3_get_tag(3) also supports ID3 tags of version 2.2, 2.3 and 2.4. To extract information from these tags, pass one of the con-
stants ID3_V2_2, ID3_V2_3 or ID3_V2_4 as the second parameter. ID3 v2.x tags can contain a lot more information about the MP3 file
than ID3 v1.x tags.
RETURN VALUES
Returns an associative array with various keys like: title, artist, ..
The key genre will contain an integer between 0 and 147. You may use id3_get_genre_name(3) to convert it to a human readable string.
EXAMPLES
Example #1
id3_get_tag(3) example
<?php
$tag = id3_get_tag( "path/to/example.mp3" );
print_r($tag);
?>
The above example will output something similar to:
Array
(
[title] => DN-38416
[artist] => Re:Legion
[album] => Reflections
[year] => 2004
[genre] => 19
)
Example #2
id3_get_tag(3) example
<?php
$tag = id3_get_tag( "path/to/example2.mp3", ID3_V2_3 );
print_r($tag);
?>
The above example will output something similar to:
Array
(
[copyright] => Dirty Mac
[originalArtist] => Dirty Mac
[composer] => Marcus Gotze
[artist] => Dirty Mac
[title] => Little Big Man
[album] => Demo-Tape
[track] => 5/12
[genre] => (17)Rock
[year] => 2001
)
SEE ALSO id3_set_tag(3), id3_remove_tag(3), id3_get_version(3).
PHP Documentation Group ID3_GET_TAG(3)
Check Out this Related Man Page
MP3::Tag::CDDB_File(3pm) User Contributed Perl Documentation MP3::Tag::CDDB_File(3pm)NAME
MP3::Tag::CDDB_File - Module for parsing CDDB files.
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();
see MP3::Tag
DESCRIPTION
MP3::Tag::CDDB_File is designed to be called from the MP3::Tag module.
It parses the content of CDDB file.
The file is found in the same directory as audio file; the list of possible file names is taken from the field "cddb_files" if set by
MP3::Tag config() method.
parse()
($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
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 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()
$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 'Trackcomment' entry of the file. (Often not present.)
genre()
$genre = $db->genre($filename);
perl v5.14.2 2009-04-15 MP3::Tag::CDDB_File(3pm)