cvs: phpdoc-fr /reference/id3/functions id3-get-frame-long-name.xml id3-get-frame-short-name.xml id3-get-genre-id.xml id3-get-genre-list.xml
id3-get-genre-name.xml id3-get-tag.xml id3-get-version.xml id3-remove-tag.xml id3-set-tag.xml

From: Date: Sun, 14 Jan 2007 08:38:37 +0000
Subject: cvs: phpdoc-fr /reference/id3/functions id3-get-frame-long-name.xml id3-get-frame-short-name.xml id3-get-genre-id.xml id3-get-genre-list.xml
id3-get-genre-name.xml id3-get-tag.xml id3-get-version.xml id3-remove-tag.xml id3-set-tag.xml
Groups: php.doc.fr 
Request: Send a blank email to doc-fr+get-5165@lists.php.net to get a copy of this message
yannick Sun Jan 14 08:38:37 2007 UTC Modified files: /phpdoc-fr/reference/id3/functions id3-get-frame-long-name.xml id3-get-frame-short-name.xml id3-get-genre-id.xml id3-get-genre-list.xml id3-get-genre-name.xml id3-get-tag.xml id3-get-version.xml id3-remove-tag.xml id3-set-tag.xml Log: sync with EN

http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/id3/functions/id3-get-frame-long-name.xml?r1=1.2&r2=1.3&diff_format=u Index: phpdoc-fr/reference/id3/functions/id3-get-frame-long-name.xml diff -u phpdoc-fr/reference/id3/functions/id3-get-frame-long-name.xml:1.2 phpdoc-fr/reference/id3/functions/id3-get-frame-long-name.xml:1.3 --- phpdoc-fr/reference/id3/functions/id3-get-frame-long-name.xml:1.2 Mon Aug 28 12:53:39 2006 +++ phpdoc-fr/reference/id3/functions/id3-get-frame-long-name.xml Sun Jan 14 08:38:37 2007 @@ -1,50 +1,77 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.2 $ --> -<!-- EN-Revision: 1.1 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.3 $ --> +<!-- EN-Revision: 1.3 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.id3-get-frame-long-name"> - <refnamediv> - <refname>id3_get_frame_long_name</refname> - <refpurpose>Récupère le nom long d'un champs ID3v2</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>string</type><methodname>id3_get_frame_long_name</methodname> - <methodparam><type>string</type><parameter>frameId</parameter></methodparam> - </methodsynopsis> - <para> - <function>id3_get_frame_long_name</function> retourne le nom long d'un champs - ID3v2. - </para> - <para> - - </para> - <para> - <example> - <title>Exemple avec <function>id3_get_frame_long_name</function></title> - <programlisting role="php"> + + +<refentry id="function.id3-get-frame-long-name"> + <refnamediv> + <refname>id3_get_frame_long_name</refname> + <refpurpose>Récupère le nom long d'un champs ID3v2</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>id3_get_frame_long_name</methodname> + <methodparam><type>string</type><parameter>frameId</parameter></methodparam> + </methodsynopsis> + <para> + <function>id3_get_frame_long_name</function> retourne le nom long d'un champs + ID3v2. + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>frameId</parameter></term> + <listitem> + <para> + Une frame ID3v2 + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne le nom long d'un champs ou &false; si une erreur survient. + </para> + </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Exemple avec <function>id3_get_frame_long_name</function></title> + <programlisting role="php"> <![CDATA[ <?php $longName = id3_get_frame_long_name("TOLY"); echo $longName; ?> ]]> - </programlisting> - &example.outputs; - <screen> + </programlisting> + &example.outputs; + <screen> <![CDATA[ Original lyricist(s)/text writer(s) ]]> - </screen> - </example> - </para> - <para> - Voir aussi - <function>id3_get_frame_short_name</function>. - </para> - </refsect1> - </refentry> + </screen> + </example> + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>id3_get_frame_short_name</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -65,4 +92,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/id3/functions/id3-get-frame-short-name.xml?r1=1.3&r2=1.4&diff_format=u Index: phpdoc-fr/reference/id3/functions/id3-get-frame-short-name.xml diff -u phpdoc-fr/reference/id3/functions/id3-get-frame-short-name.xml:1.3 phpdoc-fr/reference/id3/functions/id3-get-frame-short-name.xml:1.4 --- phpdoc-fr/reference/id3/functions/id3-get-frame-short-name.xml:1.3 Mon Aug 28 12:53:39 2006 +++ phpdoc-fr/reference/id3/functions/id3-get-frame-short-name.xml Sun Jan 14 08:38:37 2007 @@ -1,54 +1,80 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- EN-Revision: 1.2 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.4 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.id3-get-frame-short-name"> - <refnamediv> - <refname>id3_get_frame_short_name</refname> - <refpurpose>Récupère le nom court d'un champs ID3v2</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>string</type><methodname>id3_get_frame_short_name</methodname> - <methodparam><type>string</type><parameter>frameId</parameter></methodparam> - </methodsynopsis> - <para> - <function>id3_get_frame_short_name</function> retourne le nom court d'un - champs ID3v2. - </para> - <para> - - </para> - <para> - <example> - <title>Exemple avec <function>id3_get_frame_short_name</function></title> - <programlisting role="php"> + +<refentry id="function.id3-get-frame-short-name"> + <refnamediv> + <refname>id3_get_frame_short_name</refname> + <refpurpose>Récupère le nom court d'un champs ID3v2</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>id3_get_frame_short_name</methodname> + <methodparam><type>string</type><parameter>frameId</parameter></methodparam> + </methodsynopsis> + <para> + <function>id3_get_frame_short_name</function> retourne le nom court d'un + champs ID3v2. + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>frameId</parameter></term> + <listitem> + <para> + Une frame ID3v2 + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne le nom court d'un champs ou &false; si une erreur survient. + </para> + <para> + Les valeurs retournées par <function>id3_get_short_name</function> + sont utilisées dans le tableau retourné par <function>id3_get_tag</function>. + </para> + </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Exemple avec <function>id3_get_frame_short_name</function></title> + <programlisting role="php"> <![CDATA[ <?php $shortName = id3_get_frame_short_name("TOLY"); echo $shortName; ?> ]]> - </programlisting> - &example.outputs; - <screen> + </programlisting> + &example.outputs; + <screen> <![CDATA[ originalLyricist ]]> - </screen> - </example> - </para> - <para> - Les valeurs retournées par <function>id3_get_short_name</function> - sont utilisées dans le tableau retourné par <function>id3_get_tag</function>. - </para> - <para> - Voir aussi - <function>id3_get_frame_long_name</function>. - </para> - </refsect1> - </refentry> + </screen> + </example> + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>id3_get_frame_long_name</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -69,4 +95,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/id3/functions/id3-get-genre-id.xml?r1=1.7&r2=1.8&diff_format=u Index: phpdoc-fr/reference/id3/functions/id3-get-genre-id.xml diff -u phpdoc-fr/reference/id3/functions/id3-get-genre-id.xml:1.7 phpdoc-fr/reference/id3/functions/id3-get-genre-id.xml:1.8 --- phpdoc-fr/reference/id3/functions/id3-get-genre-id.xml:1.7 Mon Aug 28 12:53:39 2006 +++ phpdoc-fr/reference/id3/functions/id3-get-genre-id.xml Sun Jan 14 08:38:37 2007 @@ -1,53 +1,76 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.7 $ --> -<!-- EN-Revision: 1.4 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.8 $ --> +<!-- EN-Revision: 1.6 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.id3-get-genre-id"> - <refnamediv> - <refname>id3_get_genre_id</refname> - <refpurpose>Récupération d'un id pour un genre</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>int</type><methodname>id3_get_genre_id</methodname> - <methodparam><type>string</type><parameter>genre</parameter></methodparam> - </methodsynopsis> - <para> - <function>id3_get_genre_id</function> retourne l'id pour un genre. - Si le genre spécifié n'est pas disponible dans la liste des genres, - <function>id3_get_genre_id</function> retournera &false;. - </para> - <para> - Dans un tag ID3, le genre est stocké en utilisant un entier compris - dans l'intervale 0-147. - </para> - <para> - <example> - <title>Exemple avec <function>id3_get_genre_id</function></title> - <programlisting role="php"> + +<refentry id="function.id3-get-genre-id"> + <refnamediv> + <refname>id3_get_genre_id</refname> + <refpurpose>Récupération d'un id pour un genre</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>int</type><methodname>id3_get_genre_id</methodname> + <methodparam><type>string</type><parameter>genre</parameter></methodparam> + </methodsynopsis> + <para> + <function>id3_get_genre_id</function> retourne l'id pour un genre. + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>genre</parameter></term> + <listitem> + <para> + Un entier compris entre 0 et 147 + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + L'id du genre ou &false; si une erreur survient. + </para> + </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Exemple avec <function>id3_get_genre_id</function></title> + <programlisting role="php"> <![CDATA[ <?php $id = id3_get_genre_id("Alternative"); echo $id; ?> ]]> - </programlisting> - &example.outputs; - <screen> + </programlisting> + &example.outputs; + <screen> <![CDATA[ 20 ]]> - </screen> - </example> - </para> - <para> - Voir aussi - <function>id3_get_genre_list</function> et - <function>id3_get_genre_name</function>. - </para> - </refsect1> - </refentry> + </screen> + </example> + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>id3_get_genre_name</function></member> + <member><function>id3_get_genre_list</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -68,4 +91,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/id3/functions/id3-get-genre-list.xml?r1=1.7&r2=1.8&diff_format=u Index: phpdoc-fr/reference/id3/functions/id3-get-genre-list.xml diff -u phpdoc-fr/reference/id3/functions/id3-get-genre-list.xml:1.7 phpdoc-fr/reference/id3/functions/id3-get-genre-list.xml:1.8 --- phpdoc-fr/reference/id3/functions/id3-get-genre-list.xml:1.7 Mon Aug 28 12:53:39 2006 +++ phpdoc-fr/reference/id3/functions/id3-get-genre-list.xml Sun Jan 14 08:38:37 2007 @@ -1,42 +1,53 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.7 $ --> -<!-- EN-Revision: 1.4 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.8 $ --> +<!-- EN-Revision: 1.6 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.id3-get-genre-list"> - <refnamediv> - <refname>id3_get_genre_list</refname> - <refpurpose>Récupère toutes les valeurs possibles du genre</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>array</type><methodname>id3_get_genre_list</methodname> - <void /> - </methodsynopsis> - <para> - <function>id3_get_genre_list</function> retourne un tableau contenant - tous les genres possibles pouvant être stockés dans un tag ID3. - La liste a été créée par Eric Kemp et, plus tard, complétée par WinAmp. - </para> - <para> - Cette fonction est pratique pour fournir à vos utilisateurs une liste de - genres depuis laquelle ils peuvent en choisir un. Lorsque vous mettez à - jour vos tags ID3, vous devez également spécifier un genre sous forme - d'entier entre 0-147. - </para> - <para> - <example> - <title>Exemple avec <function>id3_get_genre_list</function></title> - <programlisting role="php"> + +<refentry id="function.id3-get-genre-list"> + <refnamediv> + <refname>id3_get_genre_list</refname> + <refpurpose>Récupère toutes les valeurs possibles du genre</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>array</type><methodname>id3_get_genre_list</methodname> + <void /> + </methodsynopsis> + <para> + <function>id3_get_genre_list</function> retourne un tableau contenant + tous les genres possibles pouvant être stockés dans un tag ID3. + La liste a été créée par Eric Kemp et, plus tard, complétée par WinAmp. + </para> + <para> + Cette fonction est pratique pour fournir à vos utilisateurs une liste de + genres depuis laquelle ils peuvent en choisir un. Lorsque vous mettez à + jour vos tags ID3, vous devez également spécifier un genre sous forme + d'entier entre 0-147. + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne un tableau contenant tous les genres possibles qui peuvent être + stockés dans une balise ID3. + </para> + </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Exemple avec <function>id3_get_genre_list</function></title> + <programlisting role="php"> <![CDATA[ <?php $genres = id3_get_genre_list(); print_r($genres); ?> ]]> - </programlisting> - &example.outputs; - <screen> + </programlisting> + &example.outputs; + <screen> <![CDATA[ Array ( @@ -190,16 +201,20 @@ [147] => SynthPop ) ]]> - </screen> - </example> - </para> - <para> - Voir aussi - <function>id3_get_genre_name</function> et - <function>id3_get_genre_id</function>. - </para> - </refsect1> - </refentry> + </screen> + </example> + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>id3_get_genre_name</function></member> + <member><function>id3_get_genre_id</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -220,4 +235,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/id3/functions/id3-get-genre-name.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc-fr/reference/id3/functions/id3-get-genre-name.xml diff -u phpdoc-fr/reference/id3/functions/id3-get-genre-name.xml:1.6 phpdoc-fr/reference/id3/functions/id3-get-genre-name.xml:1.7 --- phpdoc-fr/reference/id3/functions/id3-get-genre-name.xml:1.6 Mon Aug 28 12:53:39 2006 +++ phpdoc-fr/reference/id3/functions/id3-get-genre-name.xml Sun Jan 14 08:38:37 2007 @@ -1,52 +1,76 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<!-- EN-Revision: 1.3 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.5 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.id3-get-genre-name"> - <refnamediv> - <refname>id3_get_genre_name</refname> - <refpurpose>Récupère le nom pour un id de genre</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>string</type><methodname>id3_get_genre_name</methodname> - <methodparam><type>int</type><parameter>genre_id</parameter></methodparam> - </methodsynopsis> - <para> - <function>id3_get_genre_name</function> retourne le nom pour le genre - dont l'identifiant est <parameter>genre_id</parameter>. - </para> - <para> - Dans un tag ID3, le genre est stocké en utilisant un entier compris entre - 0 et 147. - </para> - <para> - <example> - <title>Exemple avec <function>id3_get_genre_name</function></title> - <programlisting role="php"> + +<refentry id="function.id3-get-genre-name"> + <refnamediv> + <refname>id3_get_genre_name</refname> + <refpurpose>Récupère le nom pour un id de genre</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>id3_get_genre_name</methodname> + <methodparam><type>int</type><parameter>genre_id</parameter></methodparam> + </methodsynopsis> + <para> + <function>id3_get_genre_name</function> retourne le nom pour un id de genre spécifié. + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>genre_id</parameter></term> + <listitem> + <para> + Un entier, compris entre 0 et 147 + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne le nom sous la forme d'une chaîne de caractères. + </para> + </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Exemple avec <function>id3_get_genre_name</function></title> + <programlisting role="php"> <![CDATA[ <?php $genre = id3_get_genre_name(20); echo $genre; ?> ]]> - </programlisting> - &example.outputs; - <screen> + </programlisting> + &example.outputs; + <screen> <![CDATA[ Alternative ]]> - </screen> - </example> - </para> - <para> - Voir aussi - <function>id3_get_genre_list</function> et - <function>id3_get_genre_id</function>. - </para> - </refsect1> - </refentry> + </screen> + </example> + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>id3_get_genre_list</function></member> + <member><function>id3_get_genre_id</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -67,4 +91,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/id3/functions/id3-get-tag.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc-fr/reference/id3/functions/id3-get-tag.xml diff -u phpdoc-fr/reference/id3/functions/id3-get-tag.xml:1.5 phpdoc-fr/reference/id3/functions/id3-get-tag.xml:1.6 --- phpdoc-fr/reference/id3/functions/id3-get-tag.xml:1.5 Mon Aug 28 12:53:39 2006 +++ phpdoc-fr/reference/id3/functions/id3-get-tag.xml Sun Jan 14 08:38:37 2007 @@ -1,47 +1,88 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- EN-Revision: 1.2 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.4 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.id3-get-tag"> - <refnamediv> - <refname>id3_get_tag</refname> - <refpurpose>Récupère toutes les informations stockées dans un tag ID3</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>array</type><methodname>id3_get_tag</methodname> - <methodparam><type>string</type><parameter>filename</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>version</parameter></methodparam> - </methodsynopsis> - <para> - <function>id3_get_tag</function> est utilisée pour récupérer toutes les + +<refentry id="function.id3-get-tag"> + <refnamediv> + <refname>id3_get_tag</refname> + <refpurpose>Récupère toutes les informations stockées dans un tag ID3</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>array</type><methodname>id3_get_tag</methodname> + <methodparam><type>string</type><parameter>filename</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>version</parameter></methodparam> + </methodsynopsis> + <para> + <function>id3_get_tag</function> est utilisée pour récupérer toutes les informations stockées dans un tag ID3 d'un fichier spécifique. - </para> - <note> - <simpara> - Au lieu d'un nom de fichier, vous pouvez également passer une ressource - valide. - </simpara> - </note> - <para> - Le paramètre optionnel <parameter>version</parameter> vous permet de - spécifier la version du tag, bien que les fichiers MP3 doivent contenir - à la fois les versions 1.x et les versions 2.x. - </para> - <para> - <example> - <title>Exemple avec <function>id3_get_tag</function></title> - <programlisting role="php"> + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>filename</parameter></term> + <listitem> + <para> + Le chemin vers le fichier MP3 + </para> + <para> + Au lieu de passer un nom de fichier, vous pouvez aussi passer + un flux de ressource valide. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>version</parameter></term> + <listitem> + <para> + Vous permet de spécifier la version du tag, bien que les fichiers MP3 + doivent contenir à la fois les versions 1.x et les versions 2.x. + </para> + <para> + Depuis la version 0.2, <function>id3_get_tag</function> supporte + également les tags ID3 version 2.2, 2.3 et 2.4. Pour extraire les + informations de ces tags, passez une des constantes ID3_V2_2, ID3_V2_3 + ou ID3_V2_4 en tant que second paramètre. Les tags ID3 v2.x + peuvent contenir beaucoup plus d'informations sur le fichier MP3 + que les versions ID3 v1.x. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne un tableau associatif avec diverses clés, comme : + <literal>title</literal>, <literal>artist</literal>, .. + </para> + <para> + La clé <literal>genre</literal> doit contenir un entier compris entre 0 + et 147. Vous pouvez utiliser la fonction <function>id3_get_genre_name</function> + pour convertir ce nombre en une chaîne lisible humainement. + </para> + </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Exemple avec <function>id3_get_tag</function></title> + <programlisting role="php"> <![CDATA[ <?php -$tag = id3_get_tag( "chemin/vers/exemple.mp3" ); +$tag = id3_get_tag( "path/to/example.mp3" ); print_r($tag); ?> ]]> - </programlisting> - &example.outputs; - <screen> + </programlisting> + &example.outputs.similar; + <screen> <![CDATA[ Array ( @@ -52,34 +93,20 @@ [genre] => 19 ) ]]> - </screen> - </example> - </para> - <para> - La clé <literal>genre</literal> doit contenir un entier compris entre 0 - et 147. Vous pouvez utiliser la fonction - <function>id3_get_genre_name</function> pour convertir ce nombre en une - chaîne lisible humainement. - </para> - <para> - Depuis la version 0.2, <function>id3_get_tag</function> supporte également les tags - ID3 version 2.2, 2.3 et 2.4. - Pour extraire les informations de ces tags, passez une des constantes ID3_V2_2, ID3_V2_3 - ou ID3_V2_4 en tant que second paramètre. - </para> - <para> - <example> - <title>Exemple avec <function>id3_get_tag</function></title> - <programlisting role="php"> + </screen> + </example> + <example> + <title>Exemple avec <function>id3_get_tag</function></title> + <programlisting role="php"> <![CDATA[ <?php -$tag = id3_get_tag( "chemin/vers/exemple2.mp3", ID3_V2_3 ); +$tag = id3_get_tag( "path/to/example2.mp3", ID3_V2_3 ); print_r($tag); ?> ]]> - </programlisting> - &example.outputs.similar; - <screen> + </programlisting> + &example.outputs.similar; + <screen> <![CDATA[ Array ( @@ -94,21 +121,21 @@ [year] => 2001 ) ]]> - </screen> - </example> - </para> - <para> - Les tags ID3 v2.x peuvent contenir beaucoup plus d'informations concernant un fichier - MP3 par rapport aux tags ID3 version 1.x. - </para> - <para> - Voir aussi - <function>id3_set_tag</function>, - <function>id3_remove_tag</function> et - <function>id3_get_version</function>. - </para> - </refsect1> - </refentry> + </screen> + </example> + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>id3_set_tag</function></member> + <member><function>id3_remove_tag</function></member> + <member><function>id3_get_version</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -129,4 +156,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/id3/functions/id3-get-version.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc-fr/reference/id3/functions/id3-get-version.xml diff -u phpdoc-fr/reference/id3/functions/id3-get-version.xml:1.5 phpdoc-fr/reference/id3/functions/id3-get-version.xml:1.6 --- phpdoc-fr/reference/id3/functions/id3-get-version.xml:1.5 Mon Aug 28 12:53:39 2006 +++ phpdoc-fr/reference/id3/functions/id3-get-version.xml Sun Jan 14 08:38:37 2007 @@ -1,72 +1,100 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- EN-Revision: 1.1 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.3 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.id3-get-version"> - <refnamediv> - <refname>id3_get_version</refname> - <refpurpose>Récupère la version d'un tag ID3</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>int</type><methodname>id3_get_version</methodname> - <methodparam><type>string</type><parameter>filename</parameter></methodparam> - </methodsynopsis> - <para> - <function>id3_get_version</function> retourne la(les) version(s) du(des) - tag(s) ID3 d'un fichier MP3. Sachant qu'un tag peut contenir des tags ID3 - de version v1.x et v2.x, la valeur retournée par cette fonction doit être - comparée au niveau binaire avec les constantes pré-définies - <constant>ID3_V1_0</constant>, <constant>ID3_V1_1</constant> et - <constant>ID3_V2</constant>. - </para> - <note> - <simpara> - Au lieu d'un nom de fichier, vous pouvez également passer une ressource - valide. - </simpara> - </note> - <para> - <example> - <title>Exemple avec <function>id3_get_version</function></title> - <programlisting role="php"> + +<refentry id="function.id3-get-version"> + <refnamediv> + <refname>id3_get_version</refname> + <refpurpose>Récupère la version d'un tag ID3</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>int</type><methodname>id3_get_version</methodname> + <methodparam><type>string</type><parameter>filename</parameter></methodparam> + </methodsynopsis> + <para> + <function>id3_get_version</function> récupère la(les) version(s) + de la(des) balise(s) ID3 d'un fichier MP3. + </para> + <para> + Si un fichier contient une balise ID3 v1.1, il contiendra toujours + aussi une balise 1.0, vu que 1.1 est uniquement une extension de 1.0. + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>filename</parameter></term> + <listitem> + <para> + Le chemin vers le fichier MP3 + </para> + <para> + Au lieu de passer un nom de fichier, vous pouvez aussi passer un + flux de ressource valide. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne la(les) version(s) du(des) tag(s) ID3 d'un fichier MP3. + Sachant qu'un tag peut contenir des tags ID3 de version v1.x + et v2.x, la valeur retournée par cette fonction doit être + comparée au niveau binaire avec les constantes pré-définies + <constant>ID3_V1_0</constant>, <constant>ID3_V1_1</constant> et + <constant>ID3_V2</constant>. + </para> + </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Exemple avec <function>id3_get_version</function></title> + <programlisting role="php"> <![CDATA[ <?php -$version = id3_get_version("chemin/vers/exemple.mp3"); +$version = id3_get_version( "path/to/example.mp3" ); if ($version & ID3_V1_0) { - echo "Contient un tag version 1.x\n"; + echo "Contains a 1.x tag\n"; } if ($version & ID3_V1_1) { - echo "Contient un tag version 1.1\n"; + echo "Contains a 1.1 tag\n"; } if ($version & ID3_V2) { - echo "Contient un tag version 2.x\n"; + echo "Contains a 2.x tag\n"; } ?> ]]> - </programlisting> - &example.outputs; - <screen> + </programlisting> + &example.outputs.similar; + <screen> <![CDATA[ -Contient un tag version 1.x -Contient un tag version 1.1 +Contains a 1.x tag +Contains a 1.1 tag ]]> - </screen> - </example> - </para> - <para> - Si un fichier contient un tag ID3 v1.1, il contient toujours un tag 1.0, - vu que la version 1.1 n'est qu'une extension de la version 1.0. - </para> - <para> - Voir aussi - <function>id3_get_tag</function>, - <function>id3_set_tag</function> et - <function>id3_remove_tag</function>. - </para> - </refsect1> - </refentry> + </screen> + </example> + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>id3_set_tag</function></member> + <member><function>id3_get_tag</function></member> + <member><function>id3_remove_tag</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -87,4 +115,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/id3/functions/id3-remove-tag.xml?r1=1.4&r2=1.5&diff_format=u Index: phpdoc-fr/reference/id3/functions/id3-remove-tag.xml diff -u phpdoc-fr/reference/id3/functions/id3-remove-tag.xml:1.4 phpdoc-fr/reference/id3/functions/id3-remove-tag.xml:1.5 --- phpdoc-fr/reference/id3/functions/id3-remove-tag.xml:1.4 Mon Aug 28 12:53:39 2006 +++ phpdoc-fr/reference/id3/functions/id3-remove-tag.xml Sun Jan 14 08:38:37 2007 @@ -1,76 +1,108 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> -<!-- EN-Revision: 1.2 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.5 $ --> +<!-- EN-Revision: 1.4 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.id3-remove-tag"> - <refnamediv> - <refname>id3_remove_tag</refname> - <refpurpose>Efface un tag ID3</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>bool</type><methodname>id3_remove_tag</methodname> - <methodparam><type>string</type><parameter>filename</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>version</parameter></methodparam> - </methodsynopsis> - <para> - <function>id3_remove_tag</function> est utilisé pour affacer les informations - stockées dans un tag ID3. Si aucun tag n'est présent, - <function>id3_remove_tag</function> retournera &false; et quitte le fichier - tel que. - </para> - <note> - <simpara> - Au lieu d'un nom de fichier, vous pouvez également passer une ressource - valide. - </simpara> - </note> - <para> - Le paramètre optionnel <parameter>version</parameter> vous permet de - spécifier la version du tag, bien que les fichiers MP3 doivent contenir - à la fois les versions 1.x et les versions 2.x. - </para> - <para> - <example> - <title>Exemple avec <function>id3_remove_tag</function></title> - <programlisting role="php"> + +<refentry id="function.id3-remove-tag"> + <refnamediv> + <refname>id3_remove_tag</refname> + <refpurpose>Efface un tag ID3</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>id3_remove_tag</methodname> + <methodparam><type>string</type><parameter>filename</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>version</parameter></methodparam> + </methodsynopsis> + <para> + <function>id3_remove_tag</function> est utilisé pour affacer les informations + stockées dans un tag ID3. + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>filename</parameter></term> + <listitem> + <para> + Le chemin vers le fichier MP3 + </para> + <para> + Au lieu d'un nom de fichier, vous pouvez également passer une ressource + valide. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>version</parameter></term> + <listitem> + <para> + Vous permet de spécifier la version du tag, bien que les fichiers MP3 + doivent contenir à la fois les versions 1.x et les versions 2.x. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.success; + </para> + </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Exemple avec <function>id3_remove_tag</function></title> + <programlisting role="php"> <![CDATA[ <?php -$result = id3_remove_tag( "chemin/vers/exemple.mp3", ID3_V1_0 ); +$result = id3_remove_tag( "path/to/example.mp3", ID3_V1_0 ); if ($result === true) { echo "Le tag a été effacé avec succès\n"; } ?> ]]> - </programlisting> - <para> - Si le fichier est accessible en écriture et qu'il contient un tag 1.0, - l'exemple affichera : - </para> - <screen> + </programlisting> + <para> + Si le fichier est accessible en écriture et qu'il contient un tag 1.0, + l'exemple affichera : + </para> + <screen> <![CDATA[ Le tag a été effacé avec succès ]]> - </screen> - </example> - </para> - <note> - <simpara> - Actuellement, <function>id3_remove_tag</function> supporte uniquement - les tags version 1.0 et 1.1. Si vous tentez d'effacer un tag 1.0 et que le fichier - contient un tag 1.1, le tag sera effacé car la version 1.1 n'est qu'une extension - de la version 1.0. - </simpara> - </note> - <para> - Voir aussi - <function>id3_get_tag</function>, - <function>id3_set_tag</function> et - <function>id3_get_version</function>. - </para> - </refsect1> - </refentry> + </screen> + </example> + </para> + </refsect1> + <refsect1 role="notes"> + &reftitle.notes; + <note> + <simpara> + Actuellement, <function>id3_remove_tag</function> supporte uniquement + les tags version 1.0 et 1.1. Si vous tentez d'effacer un tag 1.0 et que le fichier + contient un tag 1.1, le tag sera effacé car la version 1.1 n'est qu'une extension + de la version 1.0. + </simpara> + </note> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>id3_set_tag</function></member> + <member><function>id3_get_tag</function></member> + <member><function>id3_get_version</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -91,4 +123,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/id3/functions/id3-set-tag.xml?r1=1.4&r2=1.5&diff_format=u Index: phpdoc-fr/reference/id3/functions/id3-set-tag.xml diff -u phpdoc-fr/reference/id3/functions/id3-set-tag.xml:1.4 phpdoc-fr/reference/id3/functions/id3-set-tag.xml:1.5 --- phpdoc-fr/reference/id3/functions/id3-set-tag.xml:1.4 Mon Aug 28 12:53:39 2006 +++ phpdoc-fr/reference/id3/functions/id3-set-tag.xml Sun Jan 14 08:38:37 2007 @@ -1,39 +1,129 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> -<!-- EN-Revision: 1.2 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.5 $ --> +<!-- EN-Revision: 1.4 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.id3-set-tag"> - <refnamediv> - <refname>id3_set_tag</refname> - <refpurpose>Met à jour les informations stockées dans un tag ID3</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>bool</type><methodname>id3_set_tag</methodname> - <methodparam><type>string</type><parameter>filename</parameter></methodparam> - <methodparam><type>array</type><parameter>tag</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>version</parameter></methodparam> - </methodsynopsis> - <para> - <function>id3_set_tag</function> est utilisé pour changer les informations stockées - dans un tag ID3. Si aucun tag n'est présent, le tag sera ajouté au fichier. - </para> - <note> - <simpara> - Au lieu d'un nom de fichier, vous pouvez également passer une ressource - valide. - </simpara> - </note> - <para> - Le paramètre optionnel <parameter>version</parameter> vous permet de - spécifier la version du tag, bien que les fichiers MP3 doivent contenir - à la fois les versions 1.x et les versions 2.x. - </para> - <para> - <example> - <title>Exemple avec <function>id3_set_tag</function></title> - <programlisting role="php"> + +<refentry id="function.id3-set-tag"> + <refnamediv> + <refname>id3_set_tag</refname> + <refpurpose>Met à jour les informations stockées dans un tag ID3</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>id3_set_tag</methodname> + <methodparam><type>string</type><parameter>filename</parameter></methodparam> + <methodparam><type>array</type><parameter>tag</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>version</parameter></methodparam> + </methodsynopsis> + <para> + <function>id3_set_tag</function> est utilisé pour changer les informations stockées + dans un tag ID3. Si aucun tag n'est présent, le tag sera ajouté au fichier. + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>filename</parameter></term> + <listitem> + <para> + Le chemin vers le fichier MP3 + </para> + <para> + Au lieu d'un nom de fichier, vous pouvez également passer une ressource + valide. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>tag</parameter></term> + <listitem> + <para> + Un tableau associatif de clés et de valeurs de tags + </para> + <para> + Les clés suivantes peuvent être utilisées dans le tableau associatif : + </para> + <para> + <table> + <title>Clés dans le tableau associatif</title> + <tgroup cols="3"> + <thead> + <row> + <entry>Clé</entry> + <entry>Valeur possible</entry> + <entry>Disponible dans la version</entry> + </row> + </thead> + <tbody> + <row> + <entry>title</entry> + <entry>chaîne de caractères avec un maximum de 30 caractères</entry> + <entry>v1.0, v1.1</entry> + </row> + <row> + <entry>artist</entry> + <entry>chaîne de caractères avec un maximum de 30 caractères</entry> + <entry>v1.0, v1.1</entry> + </row> + <row> + <entry>album</entry> + <entry>chaîne de caractères avec un maximum de 30 caractères</entry> + <entry>v1.0, v1.1</entry> + </row> + <row> + <entry>year</entry> + <entry>4 digits</entry> + <entry>v1.0, v1.1</entry> + </row> + <row> + <entry>genre</entry> + <entry>valeur entière comprise entre 0 et 147</entry> + <entry>v1.0, v1.1</entry> + </row> + <row> + <entry>comment</entry> + <entry>chaîne de caractères avec un maximum de 30 caractères (28 en v1.1)</entry> + <entry>v1.0, v1.1</entry> + </row> + <row> + <entry>track</entry> + <entry>entier compris entre 0 et 255</entry> + <entry>v1.1</entry> + </row> + </tbody> + </tgroup> + </table> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>version</parameter></term> + <listitem> + <para> + Vous permet de spécifier la version du tag, bien que les + fichiers MP3 doivent contenir à la fois les versions 1.x et + les versions 2.x. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.success; + </para> + </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Exemple avec <function>id3_set_tag</function></title> + <programlisting role="php"> <![CDATA[ <?php $data = array( @@ -47,85 +137,38 @@ } ?> ]]> - </programlisting> - <para> - Si le fichier est accessible en écriture, l'exemple affichera : - </para> - <screen> + </programlisting> + <para> + Si le fichier est accessible en écriture, l'exemple affichera : + </para> + <screen> <![CDATA[ Le tag a été mis à jour avec succès ]]> - </screen> - </example> - </para> - <note> - <simpara> - Actuellement, <function>id3_set_tag</function> supporte uniquement - les versions 1.0 et 1.1. - </simpara> - </note> - <para> - Les clés suivantes peuvent être utilisées dans le tableau associatif : - </para> - <para> - <table> - <title>Clés dans le tableau associatif</title> - <tgroup cols="3"> - <thead> - <row> - <entry>Clé</entry> - <entry>Valeur possible</entry> - <entry>disponible dans la version</entry> - </row> - </thead> - <tbody> - <row> - <entry>title</entry> - <entry>chaîne de caractères avec un maximum de 30 caractères</entry> - <entry>v1.0, v1.1</entry> - </row> - <row> - <entry>artist</entry> - <entry>chaîne de caractères avec un maximum de 30 caractères</entry> - <entry>v1.0, v1.1</entry> - </row> - <row> - <entry>album</entry> - <entry>chaîne de caractères avec un maximum de 30 caractères</entry> - <entry>v1.0, v1.1</entry> - </row> - <row> - <entry>year</entry> - <entry>4 chiffres</entry> - <entry>v1.0, v1.1</entry> - </row> - <row> - <entry>genre</entry> - <entry>valeur entière comprise entre 0 et 147</entry> - <entry>v1.0, v1.1</entry> - </row> - <row> - <entry>comment</entry> - <entry>chaîne de caractères avec un maximum de 30 caractères (28 en v1.1)</entry> - <entry>v1.0, v1.1</entry> - </row> - <row> - <entry>track</entry> - <entry>entier compris entre 0 et 255</entry> - <entry>v1.1</entry> - </row> - </tbody> - </tgroup> - </table> - </para> - <para> - Voir aussi - <function>id3_get_tag</function>, - <function>id3_remove_tag</function> et - <function>id3_get_version</function>. - </para> - </refsect1> - </refentry> + </screen> + </example> + </para> + </refsect1> + <refsect1 role="notes"> + &reftitle.notes; + <note> + <simpara> + Actuellement, <function>id3_set_tag</function> supporte uniquement + les versions 1.0 et 1.1. + </simpara> + </note> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>id3_remove_tag</function></member> + <member><function>id3_get_tag</function></member> + <member><function>id3_get_version</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -146,4 +189,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file
« previous php.doc.fr (#5165) next »