mp3::tag::inf(3pm) [debian man page]

MP3::Tag::Inf(3pm)					User Contributed Perl Documentation					MP3::Tag::Inf(3pm)

NAME

       MP3::Tag::Inf - Module for parsing .inf files associated with music tracks.

SYNOPSIS

	 my $mp3inf = MP3::Tag::Inf->new($filename);   # Name of MP3 or .INF file
						       # or an MP3::Tag::File object

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

       see MP3::Tag

DESCRIPTION

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

       It parses the content of .inf file (created, e.g., by cdda2wav).

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

	   parse_filename() extracts information about artist, title, track number, album and year from the .inf file.	$what is optional; it
	   maybe title, track, artist, album, year or comment. If $what is defined parse() will return only this element.

	   As a side effect of this call, $mp3inf->{info} is set to the hash reference with the content of particular elements of the .inf file.
	   Typically present are the following fields:

	     CDINDEX_DISCID
	     CDDB_DISCID
	     MCN
	     ISRC
	     Albumperformer
	     Performer
	     Albumtitle
	     Tracktitle
	     Tracknumber
	     Trackstart
	     Tracklength
	     Pre-emphasis
	     Channels
	     Copy_permitted
	     Endianess
	     Index

	   The following fields are also recognized:

	     Year
	     Trackcomment

perl v5.14.2							    2009-04-15							MP3::Tag::Inf(3pm)

ID3_SET_TAG(3)								 1							    ID3_SET_TAG(3)

id3_set_tag - Update information stored in an ID3 tag

SYNOPSIS

       bool id3_set_tag (string  $filename, array  $tag, [int  $version = ID3_V1_0])

DESCRIPTION

       id3_set_tag(3) is used to change the information stored of an ID3 tag. If no tag has been present, it will be added to the file.

PARAMETERS

	      o $filename
		- The path to the MP3 file  Instead of a filename you may also pass a valid stream resource

	      o $tag
		- An associative array of tag keys and values  The following keys may be used in the associative array:

	      Keys in the associative array

	      +--------+--------------------------------------+---+
	      |  key   |				      |   |
	      |        |				      |   |
	      |        |	    possible value	      |   |
	      |        |				      |   |
	      |        |	 available in version	      |   |
	      |        |				      |   |
	      +--------+--------------------------------------+---+
	      | title  |				      |   |
	      |        |				      |   |
	      |        | string with maximum of 30 characters |   |
	      |        |				      |   |
	      |        |	      v1.0, v1.1	      |   |
	      |        |				      |   |
	      |artist  |				      |   |
	      |        |				      |   |
	      |        | string with maximum of 30 characters |   |
	      |        |				      |   |
	      |        |	      v1.0, v1.1	      |   |
	      |        |				      |   |
	      | album  |				      |   |
	      |        |				      |   |
	      |        | string with maximum of 30 characters |   |
	      |        |				      |   |
	      |        |	      v1.0, v1.1	      |   |
	      |        |				      |   |
	      | year   |				      |   |
	      |        |				      |   |
	      |        |	       4 digits 	      |   |
	      |        |				      |   |
	      |        |	      v1.0, v1.1	      |   |
	      |        |				      |   |
	      | genre  |				      |   |
	      |        |				      |   |
	      |        |   integer value between 0 and 147    |   |
	      |        |				      |   |
	      |        |	      v1.0, v1.1	      |   |
	      |        |				      |   |
	      |comment |				      |   |
	      |        |				      |   |
	      |        | string with maximum of 30 characters |   |
	      |        | (28 in v1.1)			      |   |
	      |        |				      |   |
	      |        |	      v1.0, v1.1	      |   |
	      |        |				      |   |
	      | track  |				      |   |
	      |        |				      |   |
	      |        |      integer between 0 and 255       |   |
	      |        |				      |   |
	      |        |		 v1.1		      |   |
	      |        |				      |   |
	      +--------+--------------------------------------+---+
	      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

RETURN VALUES

	Returns TRUE on success or FALSE on failure.

EXAMPLES

       Example #1

	      id3_set_tag(3) example

	      <?php
	      $data = array(
			    "title" => "Re:Start",
			    "artist" => "Re:Legion",
			    "comment" => "A nice track"
			   );
	      $result = id3_set_tag( "path/to/example.mp3", $data, ID3_V1_0 );
	      if ($result === true) {
		  echo "Tag successfully updated
";
	      }
	      ?>

	       If the file is writable, this will output:

	      Tag successfully updated

NOTES

       Note

	       Currently id3_set_tag(3) only supports version 1.0 and 1.1.

SEE ALSO

       id3_remove_tag(3), id3_get_tag(3), id3_get_version(3).

PHP Documentation Group 													    ID3_SET_TAG(3)