schst Thu Dec 16 12:32:45 2004 EDT
Modified files:
/phpdoc/en/reference/id3/functions id3-get-tag.xml
Log:
added example for ID3 v2
http://cvs.php.net/diff.php/phpdoc/en/reference/id3/functions/id3-get-tag.xml?r1=1.1&r2=1.2&ty=u
Index: phpdoc/en/reference/id3/functions/id3-get-tag.xml
diff -u phpdoc/en/reference/id3/functions/id3-get-tag.xml:1.1
phpdoc/en/reference/id3/functions/id3-get-tag.xml:1.2
--- phpdoc/en/reference/id3/functions/id3-get-tag.xml:1.1 Mon Jun 28
16:25:40 2004
+++ phpdoc/en/reference/id3/functions/id3-get-tag.xml Thu Dec 16 12:32:44 2004
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.1 $ -->
+<!-- $Revision: 1.2 $ -->
<refentry id="function.id3-get-tag">
<refnamediv>
<refname>id3_get_tag</refname>
@@ -52,17 +52,51 @@
</screen>
</example>
</para>
- <note>
- <simpara>
- Currently <function>id3_get_tag</function> only supports
- version 1.0 and 1.1.
- </simpara>
- </note>
<para>
The key <literal>genre</literal> will contain an integer between 0 and
147. You may
use <function>id3_get_genre_name</function> to convert it to a human
readable string.
</para>
<para>
+ Since version 0.2 <function>id3_get_tag</function> also supports ID3 tags
of version 2.2, 2.3 and 2.4.
+ To extract information from these tags, pass one of the constants
ID3_V2_2, ID3_V2_3 or ID3_V2_4 as the
+ second parameter.
+ </para>
+ <para>
+ <example>
+ <title><function>id3_get_tag</function> example</title>
+ <programlisting role="php">
+<![CDATA[
+<?php
+$tag = id3_get_tag( "path/to/example2.mp3", ID3_V2_3 );
+print_r($tag);
+?>
+]]>
+ </programlisting>
+ <para>
+ This will output something like:
+ </para>
+ <screen>
+<![CDATA[
+Array
+(
+ [copyright] => Dirty Mac
+ [originalArtist] => Dirty Mac
+ [composer] => Marcus G�tze
+ [artist] => Dirty Mac
+ [title] => Little Big Man
+ [album] => Demo-Tape
+ [track] => 5/12
+ [genre] => (17)Rock
+ [year] => 2001
+)
+]]>
+ </screen>
+ </example>
+ </para>
+ <para>
+ ID3 v2.x tags can contain a lot more information about the MP3 file than
ID3 v1.x tags.
+ </para>
+ <para>
See also <function>id3_set_tag</function>,
<function>id3_remove_tag</function> and
<function>id3_get_version</function>.
</para>
