cvs: phpdoc-fr /reference/funchand/functions call-user-func.xml /reference/pdf reference.xml /reference/regex/functions split.xml
| From: | Yannick Torres | Date: | Fri, 16 Dec 2005 15:16:37 +0000 |
| Subject: | cvs: phpdoc-fr /reference/funchand/functions call-user-func.xml /reference/pdf reference.xml /reference/regex/functions split.xml | ||
| Groups: | php.doc.fr | ||
| Request: | Send a blank email to doc-fr+get-4723@lists.php.net to get a copy of this message | ||
yannick Fri Dec 16 15:16:37 2005 EDT
Modified files:
/phpdoc-fr/reference/funchand/functions call-user-func.xml
/phpdoc-fr/reference/pdf reference.xml
/phpdoc-fr/reference/regex/functions split.xml
Log:
sync with EN
http://cvs.php.net/viewcvs.cgi/phpdoc-fr/reference/funchand/functions/call-user-func.xml?r1=1.10&r2=1.11&diff_format=u Index: phpdoc-fr/reference/funchand/functions/call-user-func.xml diff -u phpdoc-fr/reference/funchand/functions/call-user-func.xml:1.10 phpdoc-fr/reference/funchand/functions/call-user-func.xml:1.11 --- phpdoc-fr/reference/funchand/functions/call-user-func.xml:1.10 Thu Jan 20 22:00:13 2005 +++ phpdoc-fr/reference/funchand/functions/call-user-func.xml Fri Dec 16 15:16:36 2005 @@ -1,50 +1,51 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.10 $ --> -<!-- EN-Revision: 1.13 Maintainer: yannick Status: ready --> - <refentry id="function.call-user-func"> - <refnamediv> - <refname>call_user_func</refname> - <refpurpose> - Appelle une fonction utilisateur - </refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>mixed</type><methodname>call_user_func</methodname> - <methodparam><type>callback</type><parameter>function</parameter></methodparam> - <methodparam choice="opt"><type>mixed</type><parameter>parameter</parameter></methodparam> - <methodparam choice="opt"><type>mixed</type><parameter>...</parameter></methodparam> - </methodsynopsis> - <para> - <function>call_user_func</function> appelle la fonction utilisateur - <parameter>function_name</parameter>, et lui passe les paramètres - <parameter>parameter</parameter>. - <example> - <title>Exemple avec <function>call_user_func</function></title> - <programlisting role="php"> +<!-- $Revision: 1.11 $ --> +<!-- EN-Revision: 1.14 Maintainer: yannick Status: ready --> + +<refentry id="function.call-user-func"> + <refnamediv> + <refname>call_user_func</refname> + <refpurpose> + Appelle une fonction utilisateur + </refpurpose> + </refnamediv> + <refsect1> + &reftitle.description; + <methodsynopsis> + <type>mixed</type><methodname>call_user_func</methodname> + <methodparam><type>callback</type><parameter>function</parameter></methodparam> + <methodparam choice="opt"><type>mixed</type><parameter>parameter</parameter></methodparam> + <methodparam choice="opt"><type>mixed</type><parameter>...</parameter></methodparam> + </methodsynopsis> + <para> + <function>call_user_func</function> appelle la fonction utilisateur + <parameter>function_name</parameter>, et lui passe les paramètres + <parameter>parameter</parameter>. + <example> + <title>Exemple avec <function>call_user_func</function></title> + <programlisting role="php"> <![CDATA[ <?php function barbier ($type) { echo "Vous vouliez une coupe $type, pas de problème"; } - + call_user_func('barbier', 'à la one again'); call_user_func('barbier', 'militaire'); call_user_func('barbier', 'au bol'); ?> ]]> - </programlisting> - </example> - </para> - <para> - Les méthodes d'objets peuvent être appelées statiquement - en passant <literal>array($objectname, $methodname)</literal> au - paramètre <parameter>function</parameter>. - <example> - <title>Exemple avec <function>call_user_func</function> et une méthode de classe</title> - <programlisting role="php"> + </programlisting> + </example> + </para> + <para> + Les méthodes de classes peuvent être appelées statiquement + en passant <literal>array($classname, $methodname)</literal> au + paramètre <parameter>function</parameter>. + <example> + <title>Exemple avec <function>call_user_func</function> et une méthode de classe</title> + <programlisting role="php"> <![CDATA[ <?php class maclasse { @@ -59,15 +60,15 @@ call_user_func(array($classname,'dit_bonjour')); ?> ]]> - </programlisting> - </example> - </para> - <note> - <para> - Notez que les paramètres pour <function>call_user_func</function> ne sont - pas passés par référence. - <informalexample> - <programlisting role="php"> + </programlisting> + </example> + </para> + <note> + <para> + Notez que les paramètres pour <function>call_user_func</function> ne sont + pas passés par référence. + <informalexample> + <programlisting role="php"> <![CDATA[ <?php function increment(&$var) @@ -83,18 +84,18 @@ echo $a; // 1 ?> ]]> - </programlisting> - </informalexample> - </para> - </note> - <para> - Voir aussi - <function>is_callable</function>, - <function>call_user_func_array</function>&listendand; - &seealso.callback;. - </para> - </refsect1> - </refentry> + </programlisting> + </informalexample> + </para> + </note> + <para> + Voir aussi + <function>is_callable</function>, + <function>call_user_func_array</function>&listendand; + &seealso.callback;. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -115,4 +116,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/viewcvs.cgi/phpdoc-fr/reference/pdf/reference.xml?r1=1.22&r2=1.23&diff_format=u Index: phpdoc-fr/reference/pdf/reference.xml diff -u phpdoc-fr/reference/pdf/reference.xml:1.22 phpdoc-fr/reference/pdf/reference.xml:1.23 --- phpdoc-fr/reference/pdf/reference.xml:1.22 Mon Sep 5 16:11:09 2005 +++ phpdoc-fr/reference/pdf/reference.xml Fri Dec 16 15:16:36 2005 @@ -1,22 +1,22 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.22 $ --> -<!-- EN-Revision: 1.18 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.23 $ --> +<!-- EN-Revision: 1.20 Maintainer: yannick Status: ready --> <!-- Purpose: utilspec.nontext --> <!-- Membership: pecl, external --> -<!-- Reviewed: yes --> +<!-- Reviewed: no --> - <reference id="ref.pdf"> - <title>PDF </title> - <titleabbrev>PDF</titleabbrev> - - <partintro> - <section id="pdf.intro"> - &reftitle.intro; - <simpara> +<reference id="ref.pdf"> + <title>&Functions; PDF </title> + <titleabbrev>PDF</titleabbrev> + + <partintro> + <section id="pdf.intro"> + &reftitle.intro; + <para> Les fonctions PDF permettent de créer des fichiers PDF en utilisant la bibliothèque PDFlib créée par <ulink url="&url.pdflib.merz;">Thomas Merz</ulink>. - </simpara> - <simpara> + </para> + <para> La documentation de cette section est uniquement destinée à être une introduction aux fonctions disponibles, et ne doit pas être considérée comme une référence exaustive. Reportez-vous à la @@ -24,440 +24,216 @@ de détails et d'explications. Elle fournit une excellente référence des capacités de PDFlib, et contient la documentation la plus à jour. - </simpara> - <simpara> - Toutes les fonctions de la PDFlib et du module &php; ont des noms - et des arguments identiques. Vous aurez à comprendre quelques - concepts basiques de PDF et PostScript pour l'utiliser efficacement. - Toutes les longueurs et coordonnées sont mesurées en points - PostScript. Il y a généralement 72 points PostScript pour faire - un pouche (2.54 cm), mais cela dépend de la résolution de sortie. - Reportez-vous à la documentation PDFlib inclue dans la distribution - pour plus de détails sur le système de coordonnées. - </simpara> - <simpara> - Notez que la plupart des fonctions PDF requièrent une ressource - <literal>pdf object</literal> comme premier paramètre. Voyez - <link linkend="pdf.examples">les exemples</link> ci-dessous pour - plus de détails. - </simpara> - <note> - <simpara> - Si vous êtes intéressé par des alternatives gratuites pour - générer des PDF, sans passer par des bibliothèques PDF, voyez <link - linkend="faq.using.freepdf"> cette entrée de la FAQ</link>. - </simpara> - </note> - <note> - <simpara> - Cette extension a été déplacée dans <ulink url="&url.pecl;">PECL</ulink> - depuis &php; 4.3.9. - </simpara> - </note> - </section> - - <section id="pdf.requirements"> - &reftitle.required; + </para> + <para> + Toutes les fonctions de la PDFlib et du module &php; ont des noms + et des arguments identiques. Vous aurez à comprendre quelques + concepts basiques de PDF et PostScript pour l'utiliser efficacement. + Toutes les longueurs et coordonnées sont mesurées en points + PostScript. Il y a généralement 72 points PostScript pour faire + un pouche (2.54 cm), mais cela dépend de la résolution de sortie. + Reportez-vous au manuel de référence PDFlib inclue dans la distribution + de PDFlib pour plus de détails sur le système de coordonnées. + </para> + <para> + Avec la version 6, PDFlib offre une API orientée objet pour &php; 5 + en plus de l'API orientée fonctions pour &php; 4. Voici les plus grandes + différences : En &php; 4, tout d'abord, une ressource PDF doit être récupérée + avec l'appel à une fonction comme <function>$p = PDF_new();</function> + qui sera utilisée en tant que premier paramètre dans tous les futurs appels + aux fonctions, e.g. comme dans <function>PDF_begin_document($p, "", "")</function>. + En &php; 5, un objet PDFlib est créé plutôt avec + <function>$p = new PDFlib()</function>. Cet objet offre toutes les fonctions + de l'API PDFlib en tant que méthodes, e.g. comme avec + <function>$p->begin_document("", "")</function>. + En plus, les exceptions ont été introduites en &php; 5 qui sont supportées + dans la version 6 ou supérieure de la PDFlib. + </para> + <para> + Lisez les <link linkend="pdf.examples">exemples</link> ci-dessous + pour plus d'informations. + </para> + <note> <para> - PDFlib est disponible en téléchargement à - <ulink url="&url.pdf;">&url.pdf;</ulink>, mais impose l'achat - d'une license pour l'utiliser commercialement. Les bibliothèques - <ulink url="&url.jpeg;">JPEG</ulink> et <ulink url="&url.tiff;">TIFF</ulink> - sont nécessaires pour faire fonctionner cette bibliothèque. + Si vous êtes intéressé par des alternatives gratuites pour + générer des PDF, sans passer par des bibliothèques PDF, reportez-vous à + <link linkend="faq.using.freepdf"> cette entrée de la FAQ</link>. </para> - - <section id="pdf.oldlibs.hints"> - <title>Problèmes avec les anciennes versions de PDFlib</title> - <simpara> - Toutes les versions de &php; 4 éditées après le 9 Mars 2000 - ne suportent pas les versions de PDFlib plus anciennes que PDFlib 3.0. - </simpara> - <simpara> - PDFlib 3.0 et plus récent est supporté par &php; 3.0.19 et - plus récent. - </simpara> - </section> - </section> - - &reference.pdf.configure; - - <section id="pdf.configuration"> - &reftitle.runtime; - &no.config; - </section> - - <section id="pdf.oldlibs.confusion"> - <title>Confusion entre les vieilles versions de PDFLib</title> - <simpara> - Depuis le début du support de PDF sous &php;, - (commençant avec la version PDFLib 0.6), il y a eu des milliers - de modifications dans les API de PDFLib. La plupart de ces modifications - ont été suivies par &php;, et parfois même au prix - de modifications des API &php;. Depuis la version 3.x, ces API semblent - s'être stabilisées, et &php; 4 a adopté cette - version comme le minimum nécessaire pour supporter PDF. - En conséquence de quoi, un grand nombre de fonctions vont - disparaître, ou être remplacées. Le support de - PDFLib 0.6 est complètement abandonné. La liste suivante - indique quelles sont les fonctions obsolètes en &php; 4.02, et qui - devraient être remplacées par de nouvelles versions. - </simpara> + </note> + <note> <para> - <table> - <title>Fonctions obsolètes et leur remplacement</title> - <tgroup cols="2"> - <thead> - <row> - <entry>Ancienne fonction</entry> - <entry>Remplacement</entry> - </row> - </thead> - <tbody> - <row> - <entry><function>pdf_put_image</function></entry> - <entry>Désormais inutile.</entry> - </row> - <row> - <entry><function>pdf_execute_image</function></entry> - <entry>Désormais inutile.</entry> - </row> - <row> - <entry><function>pdf_get_annotation</function></entry> - <entry><function>pdf_get_bookmark</function> en utilisant les - mêmes paramètres.</entry> - </row> - <row> - <entry><function>pdf_get_font</function></entry> - <entry><function>pdf_get_value</function> en passant - <literal>"font"</literal> comme second paramètre.</entry> - </row> - <row> - <entry><function>pdf_get_fontsize</function></entry> - <entry><function>pdf_get_value</function> en passant - <literal>"fontsize"</literal> comme second paramètre.</entry> - </row> - <row> - <entry><function>pdf_get_fontname</function></entry> - <entry><function>pdf_get_parameter</function> en passant - <literal>"fontname"</literal> comme second paramètre.</entry> - </row> - <row> - <entry><function>pdf_set_info_creator</function></entry> - <entry><function>pdf_set_info</function> en passant - <literal>"Creator"</literal> comme second paramètre.</entry> - </row> - <row> - <entry><function>pdf_set_info_title</function></entry> - <entry><function>pdf_set_info</function> en passant - <literal>"Title"</literal> comme second paramètre.</entry> - </row> - <row> - <entry><function>pdf_set_info_subject</function></entry> - <entry><function>pdf_set_info</function> en passant - <literal>"Subject"</literal> comme second paramètre.</entry> - </row> - <row> - <entry><function>pdf_set_info_author</function></entry> - <entry><function>pdf_set_info</function> en passant - <literal>"Author"</literal> comme second paramètre.</entry> - </row> - <row> - <entry><function>pdf_set_info_keywords</function></entry> - <entry><function>pdf_set_info</function> en passant - <literal>"Keywords"</literal> comme second paramètre.</entry> - </row> - <row> - <entry><function>pdf_set_leading</function></entry> - <entry><function>pdf_set_value</function> en passant - <literal>"leading"</literal> comme second paramètre.</entry> - </row> - <row> - <entry><function>pdf_set_text_rendering</function></entry> - <entry><function>pdf_set_value</function> en passant - <literal>"textrendering"</literal> comme second paramètre.</entry> - </row> - <row> - <entry><function>pdf_set_text_rise</function></entry> - <entry><function>pdf_set_value</function> en passant - <literal>"textrise"</literal> comme second paramètre.</entry> - </row> - <row> - <entry><function>pdf_set_horiz_scaling</function></entry> - <entry><function>pdf_set_value</function> en passant - <literal>"horizscaling"</literal> comme second paramètre.</entry> - </row> - <row> - <entry><function>pdf_set_text_matrix</function></entry> - <entry>Désormais abandonnée.</entry> - </row> - <row> - <entry><function>pdf_set_char_spacing</function></entry> - <entry><function>pdf_set_value</function> en passant - <literal>"charspacing"</literal> comme second paramètre.</entry> - </row> - <row> - <entry><function>pdf_set_word_spacing</function></entry> - <entry><function>pdf_set_value</function> en passant - <literal>"wordspacing"</literal> comme second paramètre.</entry> - </row> - <row> - <entry><function>pdf_set_transition</function></entry> - <entry><function>pdf_set_parameter</function> en passant - <literal>"transition"</literal> comme second paramètre.</entry> - </row> - <row> - <entry><function>pdf_open</function></entry> - <entry><function>pdf_new</function> suivie d'un appel à - <function>pdf_open_file</function></entry> - </row> - <row> - <entry><function>pdf_set_font</function></entry> - <entry><function>pdf_findfont</function> suivie d'un appel à - <function>pdf_setfont</function></entry> - </row> - <row> - <entry><function>pdf_set_duration</function></entry> - <entry><function>pdf_set_value</function> en passant - <literal>"duration"</literal> comme second paramètre.</entry> - </row> - <row> - <entry><function>pdf_open_gif</function></entry> - <entry><function>pdf_open_image_file</function> en passant - <literal>"gif"</literal> comme second paramètre.</entry> - </row> - <row> - <entry><function>pdf_open_jpeg</function></entry> - <entry><function>pdf_open_image_file</function> en passant - <literal>"jpeg"</literal> comme second paramètre.</entry> - </row> - <row> - <entry><function>pdf_open_tiff</function></entry> - <entry><function>pdf_open_image_file</function> en passant - <literal>"tiff"</literal> comme second paramètre.</entry> - </row> - <row> - <entry><function>pdf_open_png</function></entry> - <entry><function>pdf_open_image_file</function> en passant - <literal>"png"</literal> comme second paramètre.</entry> - </row> - <row> - <entry><function>pdf_get_image_width</function></entry> - <entry><function>pdf_get_value</function> en passant - <literal>"imagewidth"</literal> comme second paramètre et l'image - en troisième paramètre.</entry> - </row> - <row> - <entry><function>pdf_get_image_height</function></entry> - <entry><function>pdf_get_value</function> en passant - <literal>"imageheight"</literal> comme second paramètre et l'image - en troisième paramètre.</entry> - </row> - </tbody> - </tgroup> - </table> + Cette extension a été déplacée dans <ulink url="&url.pecl;">PECL</ulink> + depuis &php; 4.3.9. </para> - </section> + </note> + </section> - <section id="pdf.examples"> - &reftitle.examples; - <simpara> - La plupart des fonctions sont simples d'emploi. Le plus difficile - est probablement de créer un fichier PDF simple. L'exemple suivant - devrait vous mettre sur les rails. - Il crée un fichier <filename>test.pdf</filename> d'une page. - La page contient du texte "Times Roman outlined", d'une taille de 30pt. - Le texte est aussi souligné. - </simpara> - <para> - <example> - <title>Création d'un document PDF avec PDFlib</title> - <programlisting role="php"> + <section id="pdf.requirements"> + &reftitle.required; + <para> + PDFlib est disponible en téléchargement sur + <ulink url="&url.pdf;">&url.pdf;</ulink>, mais impose l'achat + d'une license pour l'utiliser commercialement. + </para> + </section> + + <section id="pdf.oldlibs.hints"> + <title>Problèmes avec les anciennes versions de PDFlib</title> + <para> + Toutes les versions de &php; 4 éditées après le 9 Mars 2000 + ne suportent pas les versions de PDFlib plus anciennes que PDFlib 3.0. + </para> + <para> + PDFlib 4.0 et plus récent est supporté par &php; 4.3 et + plus récent. + </para> + </section> + + &reference.pdf.configure; + + <section id="pdf.resources"> + &reftitle.resources; + &no.resource; + </section> + + <section id="pdf.oldlibs"> + <title>Remarque sur les fonctions obsolètes de la PDFlib</title> + <para> + Depuis &php; 4.0.5, l'extension &php; pour la PDFlib est officiellement + supportée par PDFlib GmbH. Cela signifie que toutes les fonctions décrites + dans le manuel de référence de la PDFlib (PDFlib V3.0 ou supérieur) sont + supportées par &php; 4 avec exactement la même signification et les + mêmes paramètres. Cepdentant, avec la PDFlib V5.0.4 ou supérieure, + tous les paramètres doivent être spécifiés. Pour des raisons de compatibilité, + l'implémentation de la PDFlib supporte la plupart des fonctions obsolètes, mais + elles doivent être remplacées par leur nouvelle version. PDFlib GmbH + ne fournira aucun support pour les problèmes survenant lors de l'utilisation + de ces fonctions obsolètes. La documentation de cette section indique les anciennes fonctions + comme "obsolètes" et donne la fonction qui doit être utilisée à la place. + </para> + </section> + + <section id="pdf.examples"> + &reftitle.examples; + <para> + La plupart des fonctions sont simples d'emploi. Le plus difficile + est probablement de créer un fichier PDF simple. L'exemple suivant + devrait vous mettre sur les rails. Il est développé en &php; 4 et + crée un fichier <filename>hello.pdf</filename> d'une page. + Il définit quelques champs de contenu et charge la police + <literal>Helvetica-Bold</literal> et affiche le texte "Bonjour le monde (dit PHP) !". + </para> + <para> + <example> + <title>Exemple "Bonjour le monde !" avec PDFlib en &php; 4</title> + <programlisting role="php"> <![CDATA[ <?php -$pdf = pdf_new(); -pdf_open_file($pdf, "test.pdf"); -pdf_set_info($pdf, "Author", "Uwe Steinmann"); -pdf_set_info($pdf, "Title", "Test for PHP wrapper of PDFlib 2.0"); -pdf_set_info($pdf, "Creator", "See Author"); -pdf_set_info($pdf, "Subject", "Testing"); -pdf_begin_page($pdf, 595, 842); -pdf_add_outline($pdf, "Page 1"); -$font = pdf_findfont($pdf, "Times New Roman", "winansi", 1); -pdf_setfont($pdf, $font, 10); -pdf_set_value($pdf, "textrendering", 1); -pdf_show_xy($pdf, "Times Roman outlined", 50, 750); -pdf_moveto($pdf, 50, 740); -pdf_lineto($pdf, 330, 740); -pdf_stroke($pdf); -pdf_end_page($pdf); -pdf_close($pdf); -pdf_delete($pdf); -echo '<a href="getpdf.php">terminé</a>'; -?> -]]> - </programlisting> - <para> - Le script <filename>getpdf.php</filename> ne fait que retourner - le document PDF. - </para> - </example> - <example> - <title>Affichage d'un PDF précalculé</title> - <programlisting role="php"> -<![CDATA[ -<?php -$len = filesize($filename); +$p = PDF_new(); + +/* Ouvre un nouveau fichier PDF ; insère un nom de fichier pour créer le PDF sur le disque */ +if (PDF_begin_document($p, "", "") == 0) { + die("Erreur : " . PDF_get_errmsg($p)); +} + +PDF_set_info($p, "Creator", "hello.php"); +PDF_set_info($p, "Author", "Rainer Schaaf"); +PDF_set_info($p, "Title", "Bonjour le monde (PHP) !"); + +PDF_begin_page_ext($p, 595, 842, ""); + +$font = PDF_load_font($p, "Helvetica-Bold", "winansi", ""); + +PDF_setfont($p, $font, 24.0); +PDF_set_text_pos($p, 50, 700); +PDF_show($p, "Bonjour le monde "); +PDF_continue_text($p, "(dit PHP) !"); +PDF_end_page_ext($p, ""); + +PDF_end_document($p, ""); + +$buf = PDF_get_buffer($p); +$len = strlen($buf); + header("Content-type: application/pdf"); header("Content-Length: $len"); -header("Content-Disposition: inline; filename=foo.pdf"); -readfile($filename); +header("Content-Disposition: inline; filename=hello.pdf"); +print $buf; + +PDF_delete($p); ?> ]]> - </programlisting> - </example> - </para> - <para> - La distribution de la PDFlib contient des exemples plus complexes, - qui créent une page avec une horloge à aiguille. Ici, nous utilisons - la création de pages en mémoire, pour éviter l'utilisation de - fichiers temporaires. L'exemple a été adapté à &php;. - (Cet exemple est disponible dans la documentation - <link linkend="ref.cpdf">CLibPDF</link>.) - </para> - <para> - <example> - <title>Exemple pdfclock de PDFlib</title> - <programlisting role="php"> + </programlisting> + </example> + </para> + <para> + L'exemple suivant vient avec la distribution de la PDFlib pour &php; 5. + Il utilise le nouveau gestionnaire d'exceptions ainsi que les nouvelles fonctionnalités + objets disponible en &php; 5. Il crée le fichier <filename>hello.pdf</filename> + d'une seule page. Il définit quelques champs de contenu et charge la police + <literal>Helvetica-Bold</literal> et affiche le texte "Bonjour le monde (dit PHP) !". + </para> + <para> + <example> + <title>Exemple "Bonjour le monde !" avec PDFlib en &php; 5</title> + <programlisting role="php"> <![CDATA[ <?php -$radius = 200; -$margin = 20; -$pagecount = 10; - -$pdf = pdf_new(); - -if (!pdf_open_file($pdf, "")) { - echo error; - exit; -}; - -pdf_set_parameter($pdf, "warning", "true"); - -pdf_set_info($pdf, "Creator", "pdf_clock.php"); -pdf_set_info($pdf, "Author", "Uwe Steinmann"); -pdf_set_info($pdf, "Title", "Analog Clock"); - -while ($pagecount-- > 0) { - pdf_begin_page($pdf, 2 * ($radius + $margin), 2 * ($radius + $margin)); - - pdf_set_parameter($pdf, "transition", "wipe"); - pdf_set_value($pdf, "duration", 0.5); - - pdf_translate($pdf, $radius + $margin, $radius + $margin); - pdf_save($pdf); - pdf_setrgbcolor($pdf, 0.0, 0.0, 1.0); - - /* les marques des minutes */ - pdf_setlinewidth($pdf, 2.0); - for ($alpha = 0; $alpha < 360; $alpha += 6) { - pdf_rotate($pdf, 6.0); - pdf_moveto($pdf, $radius, 0.0); - pdf_lineto($pdf, $radius-$margin/3, 0.0); - pdf_stroke($pdf); - } - pdf_restore($pdf); - pdf_save($pdf); +try { + $p = new PDFlib(); - /* les marques des 5 minutes */ - pdf_setlinewidth($pdf, 3.0); - for ($alpha = 0; $alpha < 360; $alpha += 30) { - pdf_rotate($pdf, 30.0); - pdf_moveto($pdf, $radius, 0.0); - pdf_lineto($pdf, $radius-$margin, 0.0); - pdf_stroke($pdf); + /* Ouvre un nouveau fichier PDF ; insère un nom de fichier pour créer le PDF sur le disque */ + if ($p->begin_document("", "") == 0) { + die("Erreur : " . $p->get_errmsg()); } - $ltime = getdate(); - - /* l'aiguille des heures */ - pdf_save($pdf); - pdf_rotate($pdf,-(($ltime['minutes']/60.0)+$ltime['hours']-3.0)*30.0); - pdf_moveto($pdf, -$radius/10, -$radius/20); - pdf_lineto($pdf, $radius/2, 0.0); - pdf_lineto($pdf, -$radius/10, $radius/20); - pdf_closepath($pdf); - pdf_fill($pdf); - pdf_restore($pdf); - - /* l'aiguille des minutes */ - pdf_save($pdf); - pdf_rotate($pdf,-(($ltime['seconds']/60.0)+$ltime['minutes']-15.0)*6.0); - pdf_moveto($pdf, -$radius/10, -$radius/20); - pdf_lineto($pdf, $radius * 0.8, 0.0); - pdf_lineto($pdf, -$radius/10, $radius/20); - pdf_closepath($pdf); - pdf_fill($pdf); - pdf_restore($pdf); - - /* l'aiguille des secondes */ - pdf_setrgbcolor($pdf, 1.0, 0.0, 0.0); - pdf_setlinewidth($pdf, 2); - pdf_save($pdf); - pdf_rotate($pdf, -(($ltime['seconds'] - 15.0) * 6.0)); - pdf_moveto($pdf, -$radius/5, 0.0); - pdf_lineto($pdf, $radius, 0.0); - pdf_stroke($pdf); - pdf_restore($pdf); - - /* Dessin d'un petit cercle dans le centre */ - pdf_circle($pdf, 0, 0, $radius/30); - pdf_fill($pdf); + $p->set_info("Creator", "hello.php"); + $p->set_info("Author", "Rainer Schaaf"); + $p->set_info("Title", "Bonjour le monde (PHP) !"); - pdf_restore($pdf); + $p->begin_page_ext(595, 842, ""); - pdf_end_page($pdf); + $font = $p->load_font("Helvetica-Bold", "winansi", ""); - // pour voir la différence - sleep(1); -} + $p->setfont($font, 24.0); + $p->set_text_pos(50, 700); + $p->show("Bonjour le monde "); + $p->continue_text("(dit PHP) !"); + $p->end_page_ext(""); -pdf_close($pdf); + $p->end_document(""); -$buf = pdf_get_buffer($pdf); -$len = strlen($buf); + $buf = $p->get_buffer(); + $len = strlen($buf); -header("Content-type: application/pdf"); -header("Content-Length: $len"); -header("Content-Disposition: inline; filename=foo.pdf"); -echo $buf; - -pdf_delete($pdf); + header("Content-type: application/pdf"); + header("Content-Length: $len"); + header("Content-Disposition: inline; filename=hello.pdf"); + print $buf; +} +catch (PDFlibException $e) { + die("Une exception PDFlib est survenu dans l'exemple hello :\n" . + "[" . $e->get_errnum() . "] " . $e->get_apiname() . ": " . + $e->get_errmsg() . "\n"); +} +catch (Exception $e) { + die($e); +} +$p = 0; ?> ]]> - </programlisting> - </example> - </para> - </section> + </programlisting> + </example> + </para> + </section> - <section id="pdf.seealso"> - &reftitle.seealso; - <note> - <para> - Une alternative au module module PDFlib est le module - de <ulink url="&url.cpdf;">FastIO</ulink> : ClibPDF. Voyez la - section <link linkend="ref.cpdf">ClibPDF</link> - pour plus de détails. Notez que <link linkend="ref.cpdf">ClibPDF</link> - disponse d'une API différente de PDFlib. - </para> - </note> - </section> + </partintro> - </partintro> + &reference.pdf.functions; -&reference.pdf.functions; +</reference> - </reference> <!-- Keep this comment at the end of the file Local variables: mode: sgml @@ -477,5 +253,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/viewcvs.cgi/phpdoc-fr/reference/regex/functions/split.xml?r1=1.16&r2=1.17&diff_format=u Index: phpdoc-fr/reference/regex/functions/split.xml diff -u phpdoc-fr/reference/regex/functions/split.xml:1.16 phpdoc-fr/reference/regex/functions/split.xml:1.17 --- phpdoc-fr/reference/regex/functions/split.xml:1.16 Thu May 5 16:04:34 2005 +++ phpdoc-fr/reference/regex/functions/split.xml Fri Dec 16 15:16:37 2005 @@ -1,73 +1,74 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.16 $ --> -<!-- EN-Revision: 1.5 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.17 $ --> +<!-- EN-Revision: 1.6 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> - <refentry id="function.split"> - <refnamediv> - <refname>split</refname> - <refpurpose> - Scinde une chaîne en un tableau, grâce à une expression rationnelle - </refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>array</type><methodname>split</methodname> - <methodparam><type>string</type><parameter>pattern</parameter></methodparam> - <methodparam><type>string</type><parameter>string</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>limit</parameter></methodparam> - </methodsynopsis> - <tip> - <para> - <function>preg_split</function>, qui utilise la syntaxe des expressions rationnelles - compatibles PERL, est une alternative plus rapide à <function>split</function>. - Si vous n'avez pas besoin de la puissance des expressions rationnelles, il est plus - rapide d'utiliser <function>explode</function>, qui n'utilise pas le moteur - d'expressions rationnelles. - </para> - </tip> - <para> - <function>split</function> retourne un tableau de chaînes : - chacune d'entre elle est une sous-chaîne de - <parameter>string</parameter> délimitée par les - occurrences trouvées de l'expression rationnelle - <parameter>pattern</parameter>. Si <parameter>limit</parameter> - est défini, le tableau retourné contiendra un maximum de - <parameter>limit</parameter> éléments avec le dernier élément contenant - le reste de la chaîne <parameter>string</parameter>. - Si une erreur survient, retourne - &false;. - </para> - <para> - Pour lire les 5 premiers champs d'une ligne du fichier - <filename>/etc/passwd</filename>: - <example> - <title>Exemple avec <function>split</function></title> - <programlisting role="php"> + +<refentry id="function.split"> + <refnamediv> + <refname>split</refname> + <refpurpose> + Scinde une chaîne en un tableau, grâce à une expression rationnelle + </refpurpose> + </refnamediv> + <refsect1> + &reftitle.description; + <methodsynopsis> + <type>array</type><methodname>split</methodname> + <methodparam><type>string</type><parameter>pattern</parameter></methodparam> + <methodparam><type>string</type><parameter>string</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>limit</parameter></methodparam> + </methodsynopsis> + <tip> + <para> + <function>preg_split</function>, qui utilise la syntaxe des expressions rationnelles + compatibles PERL, est une alternative plus rapide à <function>split</function>. + Si vous n'avez pas besoin de la puissance des expressions rationnelles, il est plus + rapide d'utiliser <function>explode</function>, qui n'utilise pas le moteur + d'expressions rationnelles. + </para> + </tip> + <para> + <function>split</function> retourne un tableau de chaînes : + chacune d'entre elle est une sous-chaîne de + <parameter>string</parameter> délimitée par les + occurrences trouvées de l'expression rationnelle + <parameter>pattern</parameter>. Si <parameter>limit</parameter> + est défini, le tableau retourné contiendra un maximum de + <parameter>limit</parameter> éléments avec le dernier élément contenant + le reste de la chaîne <parameter>string</parameter>. + Si une erreur survient, retourne + &false;. + </para> + <para> + Pour lire les 5 premiers champs d'une ligne du fichier + <filename>/etc/passwd</filename>: + <example> + <title>Exemple avec <function>split</function></title> + <programlisting role="php"> <![CDATA[ <?php list($user, $pass, $uid, $gid, $extra)= split (":", $passwd_line, 5); ?> ]]> - </programlisting> - </example> - </para> - <simpara> - S'il y a <replaceable>n</replaceable> occurrences de - <parameter>pattern</parameter>, le tableau retourné - contiendra <literal><replaceable>n</replaceable>+1</literal> éléments. - Par exemple, s'il n'y a aucune occurrence de <parameter>pattern</parameter>, - un tableau d'un seul élément sera retourné. Bien sûr, cela reste vrai - si <parameter>string</parameter> est une chaîne vide. - </simpara> - <para> - Pour analyser une date qui est délimitée par des /, - des points ou des tirets : - </para> - <para> - <example> - <title>Exemple avec <function>split</function></title> - <programlisting role="php"> + </programlisting> + </example> + </para> + <simpara> + S'il y a <replaceable>n</replaceable> occurrences de + <parameter>pattern</parameter>, le tableau retourné + contiendra <literal><replaceable>n</replaceable>+1</literal> éléments. + Par exemple, s'il n'y a aucune occurrence de <parameter>pattern</parameter>, + un tableau d'un seul élément sera retourné. Bien sûr, cela reste vrai + si <parameter>string</parameter> est une chaîne vide. + </simpara> + <para> + Pour analyser une date qui est délimitée par des /, + des points ou des tirets : + </para> + <para> + <example> + <title>Exemple avec <function>split</function></title> + <programlisting role="php"> <![CDATA[ <?php // Les délimiteurs peuvent être des tirets, points ou slash @@ -76,37 +77,39 @@ echo "Month: $month; Day: $day; Year: $year<br />\n"; ?> ]]> - </programlisting> - </example> - </para> - <para> - Pour les utilisateurs qui recherchent le moyen d'émuler - la commande Perl <command>@chars = split('', $str)</command>, - voyez <function>preg_split</function>. - </para> - <para> - Notez aussi que <parameter>pattern</parameter> est une - expression rationnelle. Si vous voulez utiliser - n'importe quel caractère spécial des expressions - rationnelles, vous devez les échapper. Si vous - pensez que <function>split</function> (ou toute autre expression - rationnelle) se comporte bizarrement, lisez d'abord - le fichier <filename>regex.7</filename>, inclus dans le dossier - <filename>regex/</filename> de la distribution &php; . Il est au - format manpage, et vous pourrez le lire avec une commande telle que - <command>man /usr/local/src/regex/regex.7</command>. - </para> - <para> - Voir aussi - <function>preg_split</function>, - <function>spliti</function>, - <function>explode</function>, - <function>implode</function>, - <function>chunk_split</function> et - <function>wordwrap</function>. - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + <para> + Pour les utilisateurs qui recherchent le moyen d'émuler + la commande Perl <command>@chars = split('', $str)</command>, + voyez la fonction <function>preg_split</function> ou + la fonction <function>str_split</function>. + </para> + <para> + Notez aussi que <parameter>pattern</parameter> est une + expression rationnelle. Si vous voulez utiliser + n'importe quel caractère spécial des expressions + rationnelles, vous devez les échapper. Si vous + pensez que <function>split</function> (ou toute autre expression + rationnelle) se comporte bizarrement, lisez d'abord + le fichier <filename>regex.7</filename>, inclus dans le dossier + <filename>regex/</filename> de la distribution &php; . Il est au + format manpage, et vous pourrez le lire avec une commande telle que + <command>man /usr/local/src/regex/regex.7</command>. + </para> + <para> + Voir aussi + <function>preg_split</function>, + <function>spliti</function>, + <function>str_split</function>, + <function>explode</function>, + <function>implode</function>, + <function>chunk_split</function> et + <function>wordwrap</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -127,4 +130,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/viewcvs.cgi/phpdoc-fr/reference/funchand/functions/call-user-func.xml?r1=1.10&r2=1.11&diff_format=u Index: phpdoc-fr/reference/funchand/functions/call-user-func.xml diff -u phpdoc-fr/reference/funchand/functions/call-user-func.xml:1.10 phpdoc-fr/reference/funchand/functions/call-user-func.xml:1.11 --- phpdoc-fr/reference/funchand/functions/call-user-func.xml:1.10 Thu Jan 20 22:00:13 2005 +++ phpdoc-fr/reference/funchand/functions/call-user-func.xml Fri Dec 16 15:16:36 2005 @@ -1,50 +1,51 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.10 $ --> -<!-- EN-Revision: 1.13 Maintainer: yannick Status: ready --> - <refentry id="function.call-user-func"> - <refnamediv> - <refname>call_user_func</refname> - <refpurpose> - Appelle une fonction utilisateur - </refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>mixed</type><methodname>call_user_func</methodname> - <methodparam><type>callback</type><parameter>function</parameter></methodparam> - <methodparam choice="opt"><type>mixed</type><parameter>parameter</parameter></methodparam> - <methodparam choice="opt"><type>mixed</type><parameter>...</parameter></methodparam> - </methodsynopsis> - <para> - <function>call_user_func</function> appelle la fonction utilisateur - <parameter>function_name</parameter>, et lui passe les paramètres - <parameter>parameter</parameter>. - <example> - <title>Exemple avec <function>call_user_func</function></title> - <programlisting role="php"> +<!-- $Revision: 1.11 $ --> +<!-- EN-Revision: 1.14 Maintainer: yannick Status: ready --> + +<refentry id="function.call-user-func"> + <refnamediv> + <refname>call_user_func</refname> + <refpurpose> + Appelle une fonction utilisateur + </refpurpose> + </refnamediv> + <refsect1> + &reftitle.description; + <methodsynopsis> + <type>mixed</type><methodname>call_user_func</methodname> + <methodparam><type>callback</type><parameter>function</parameter></methodparam> + <methodparam choice="opt"><type>mixed</type><parameter>parameter</parameter></methodparam> + <methodparam choice="opt"><type>mixed</type><parameter>...</parameter></methodparam> + </methodsynopsis> + <para> + <function>call_user_func</function> appelle la fonction utilisateur + <parameter>function_name</parameter>, et lui passe les paramètres + <parameter>parameter</parameter>. + <example> + <title>Exemple avec <function>call_user_func</function></title> + <programlisting role="php"> <![CDATA[ <?php function barbier ($type) { echo "Vous vouliez une coupe $type, pas de problème"; } - + call_user_func('barbier', 'à la one again'); call_user_func('barbier', 'militaire'); call_user_func('barbier', 'au bol'); ?> ]]> - </programlisting> - </example> - </para> - <para> - Les méthodes d'objets peuvent être appelées statiquement - en passant <literal>array($objectname, $methodname)</literal> au - paramètre <parameter>function</parameter>. - <example> - <title>Exemple avec <function>call_user_func</function> et une méthode de classe</title> - <programlisting role="php"> + </programlisting> + </example> + </para> + <para> + Les méthodes de classes peuvent être appelées statiquement + en passant <literal>array($classname, $methodname)</literal> au + paramètre <parameter>function</parameter>. + <example> + <title>Exemple avec <function>call_user_func</function> et une méthode de classe</title> + <programlisting role="php"> <![CDATA[ <?php class maclasse { @@ -59,15 +60,15 @@ call_user_func(array($classname,'dit_bonjour')); ?> ]]> - </programlisting> - </example> - </para> - <note> - <para> - Notez que les paramètres pour <function>call_user_func</function> ne sont - pas passés par référence. - <informalexample> - <programlisting role="php"> + </programlisting> + </example> + </para> + <note> + <para> + Notez que les paramètres pour <function>call_user_func</function> ne sont + pas passés par référence. + <informalexample> + <programlisting role="php"> <![CDATA[ <?php function increment(&$var) @@ -83,18 +84,18 @@ echo $a; // 1 ?> ]]> - </programlisting> - </informalexample> - </para> - </note> - <para> - Voir aussi - <function>is_callable</function>, - <function>call_user_func_array</function>&listendand; - &seealso.callback;. - </para> - </refsect1> - </refentry> + </programlisting> + </informalexample> + </para> + </note> + <para> + Voir aussi + <function>is_callable</function>, + <function>call_user_func_array</function>&listendand; + &seealso.callback;. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -115,4 +116,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/viewcvs.cgi/phpdoc-fr/reference/pdf/reference.xml?r1=1.22&r2=1.23&diff_format=u Index: phpdoc-fr/reference/pdf/reference.xml diff -u phpdoc-fr/reference/pdf/reference.xml:1.22 phpdoc-fr/reference/pdf/reference.xml:1.23 --- phpdoc-fr/reference/pdf/reference.xml:1.22 Mon Sep 5 16:11:09 2005 +++ phpdoc-fr/reference/pdf/reference.xml Fri Dec 16 15:16:36 2005 @@ -1,22 +1,22 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.22 $ --> -<!-- EN-Revision: 1.18 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.23 $ --> +<!-- EN-Revision: 1.20 Maintainer: yannick Status: ready --> <!-- Purpose: utilspec.nontext --> <!-- Membership: pecl, external --> -<!-- Reviewed: yes --> +<!-- Reviewed: no --> - <reference id="ref.pdf"> - <title>PDF </title> - <titleabbrev>PDF</titleabbrev> - - <partintro> - <section id="pdf.intro"> - &reftitle.intro; - <simpara> +<reference id="ref.pdf"> + <title>&Functions; PDF </title> + <titleabbrev>PDF</titleabbrev> + + <partintro> + <section id="pdf.intro"> + &reftitle.intro; + <para> Les fonctions PDF permettent de créer des fichiers PDF en utilisant la bibliothèque PDFlib créée par <ulink url="&url.pdflib.merz;">Thomas Merz</ulink>. - </simpara> - <simpara> + </para> + <para> La documentation de cette section est uniquement destinée à être une introduction aux fonctions disponibles, et ne doit pas être considérée comme une référence exaustive. Reportez-vous à la @@ -24,440 +24,216 @@ de détails et d'explications. Elle fournit une excellente référence des capacités de PDFlib, et contient la documentation la plus à jour. - </simpara> - <simpara> - Toutes les fonctions de la PDFlib et du module &php; ont des noms - et des arguments identiques. Vous aurez à comprendre quelques - concepts basiques de PDF et PostScript pour l'utiliser efficacement. - Toutes les longueurs et coordonnées sont mesurées en points - PostScript. Il y a généralement 72 points PostScript pour faire - un pouche (2.54 cm), mais cela dépend de la résolution de sortie. - Reportez-vous à la documentation PDFlib inclue dans la distribution - pour plus de détails sur le système de coordonnées. - </simpara> - <simpara> - Notez que la plupart des fonctions PDF requièrent une ressource - <literal>pdf object</literal> comme premier paramètre. Voyez - <link linkend="pdf.examples">les exemples</link> ci-dessous pour - plus de détails. - </simpara> - <note> - <simpara> - Si vous êtes intéressé par des alternatives gratuites pour - générer des PDF, sans passer par des bibliothèques PDF, voyez <link - linkend="faq.using.freepdf"> cette entrée de la FAQ</link>. - </simpara> - </note> - <note> - <simpara> - Cette extension a été déplacée dans <ulink url="&url.pecl;">PECL</ulink> - depuis &php; 4.3.9. - </simpara> - </note> - </section> - - <section id="pdf.requirements"> - &reftitle.required; + </para> + <para> + Toutes les fonctions de la PDFlib et du module &php; ont des noms + et des arguments identiques. Vous aurez à comprendre quelques + concepts basiques de PDF et PostScript pour l'utiliser efficacement. + Toutes les longueurs et coordonnées sont mesurées en points + PostScript. Il y a généralement 72 points PostScript pour faire + un pouche (2.54 cm), mais cela dépend de la résolution de sortie. + Reportez-vous au manuel de référence PDFlib inclue dans la distribution + de PDFlib pour plus de détails sur le système de coordonnées. + </para> + <para> + Avec la version 6, PDFlib offre une API orientée objet pour &php; 5 + en plus de l'API orientée fonctions pour &php; 4. Voici les plus grandes + différences : En &php; 4, tout d'abord, une ressource PDF doit être récupérée + avec l'appel à une fonction comme <function>$p = PDF_new();</function> + qui sera utilisée en tant que premier paramètre dans tous les futurs appels + aux fonctions, e.g. comme dans <function>PDF_begin_document($p, "", "")</function>. + En &php; 5, un objet PDFlib est créé plutôt avec + <function>$p = new PDFlib()</function>. Cet objet offre toutes les fonctions + de l'API PDFlib en tant que méthodes, e.g. comme avec + <function>$p->begin_document("", "")</function>. + En plus, les exceptions ont été introduites en &php; 5 qui sont supportées + dans la version 6 ou supérieure de la PDFlib. + </para> + <para> + Lisez les <link linkend="pdf.examples">exemples</link> ci-dessous + pour plus d'informations. + </para> + <note> <para> - PDFlib est disponible en téléchargement à - <ulink url="&url.pdf;">&url.pdf;</ulink>, mais impose l'achat - d'une license pour l'utiliser commercialement. Les bibliothèques - <ulink url="&url.jpeg;">JPEG</ulink> et <ulink url="&url.tiff;">TIFF</ulink> - sont nécessaires pour faire fonctionner cette bibliothèque. + Si vous êtes intéressé par des alternatives gratuites pour + générer des PDF, sans passer par des bibliothèques PDF, reportez-vous à + <link linkend="faq.using.freepdf"> cette entrée de la FAQ</link>. </para> - - <section id="pdf.oldlibs.hints"> - <title>Problèmes avec les anciennes versions de PDFlib</title> - <simpara> - Toutes les versions de &php; 4 éditées après le 9 Mars 2000 - ne suportent pas les versions de PDFlib plus anciennes que PDFlib 3.0. - </simpara> - <simpara> - PDFlib 3.0 et plus récent est supporté par &php; 3.0.19 et - plus récent. - </simpara> - </section> - </section> - - &reference.pdf.configure; - - <section id="pdf.configuration"> - &reftitle.runtime; - &no.config; - </section> - - <section id="pdf.oldlibs.confusion"> - <title>Confusion entre les vieilles versions de PDFLib</title> - <simpara> - Depuis le début du support de PDF sous &php;, - (commençant avec la version PDFLib 0.6), il y a eu des milliers - de modifications dans les API de PDFLib. La plupart de ces modifications - ont été suivies par &php;, et parfois même au prix - de modifications des API &php;. Depuis la version 3.x, ces API semblent - s'être stabilisées, et &php; 4 a adopté cette - version comme le minimum nécessaire pour supporter PDF. - En conséquence de quoi, un grand nombre de fonctions vont - disparaître, ou être remplacées. Le support de - PDFLib 0.6 est complètement abandonné. La liste suivante - indique quelles sont les fonctions obsolètes en &php; 4.02, et qui - devraient être remplacées par de nouvelles versions. - </simpara> + </note> + <note> <para> - <table> - <title>Fonctions obsolètes et leur remplacement</title> - <tgroup cols="2"> - <thead> - <row> - <entry>Ancienne fonction</entry> - <entry>Remplacement</entry> - </row> - </thead> - <tbody> - <row> - <entry><function>pdf_put_image</function></entry> - <entry>Désormais inutile.</entry> - </row> - <row> - <entry><function>pdf_execute_image</function></entry> - <entry>Désormais inutile.</entry> - </row> - <row> - <entry><function>pdf_get_annotation</function></entry> - <entry><function>pdf_get_bookmark</function> en utilisant les - mêmes paramètres.</entry> - </row> - <row> - <entry><function>pdf_get_font</function></entry> - <entry><function>pdf_get_value</function> en passant - <literal>"font"</literal> comme second paramètre.</entry> - </row> - <row> - <entry><function>pdf_get_fontsize</function></entry> - <entry><function>pdf_get_value</function> en passant - <literal>"fontsize"</literal> comme second paramètre.</entry> - </row> - <row> - <entry><function>pdf_get_fontname</function></entry> - <entry><function>pdf_get_parameter</function> en passant - <literal>"fontname"</literal> comme second paramètre.</entry> - </row> - <row> - <entry><function>pdf_set_info_creator</function></entry> - <entry><function>pdf_set_info</function> en passant - <literal>"Creator"</literal> comme second paramètre.</entry> - </row> - <row> - <entry><function>pdf_set_info_title</function></entry> - <entry><function>pdf_set_info</function> en passant - <literal>"Title"</literal> comme second paramètre.</entry> - </row> - <row> - <entry><function>pdf_set_info_subject</function></entry> - <entry><function>pdf_set_info</function> en passant - <literal>"Subject"</literal> comme second paramètre.</entry> - </row> - <row> - <entry><function>pdf_set_info_author</function></entry> - <entry><function>pdf_set_info</function> en passant - <literal>"Author"</literal> comme second paramètre.</entry> - </row> - <row> - <entry><function>pdf_set_info_keywords</function></entry> - <entry><function>pdf_set_info</function> en passant - <literal>"Keywords"</literal> comme second paramètre.</entry> - </row> - <row> - <entry><function>pdf_set_leading</function></entry> - <entry><function>pdf_set_value</function> en passant - <literal>"leading"</literal> comme second paramètre.</entry> - </row> - <row> - <entry><function>pdf_set_text_rendering</function></entry> - <entry><function>pdf_set_value</function> en passant - <literal>"textrendering"</literal> comme second paramètre.</entry> - </row> - <row> - <entry><function>pdf_set_text_rise</function></entry> - <entry><function>pdf_set_value</function> en passant - <literal>"textrise"</literal> comme second paramètre.</entry> - </row> - <row> - <entry><function>pdf_set_horiz_scaling</function></entry> - <entry><function>pdf_set_value</function> en passant - <literal>"horizscaling"</literal> comme second paramètre.</entry> - </row> - <row> - <entry><function>pdf_set_text_matrix</function></entry> - <entry>Désormais abandonnée.</entry> - </row> - <row> - <entry><function>pdf_set_char_spacing</function></entry> - <entry><function>pdf_set_value</function> en passant - <literal>"charspacing"</literal> comme second paramètre.</entry> - </row> - <row> - <entry><function>pdf_set_word_spacing</function></entry> - <entry><function>pdf_set_value</function> en passant - <literal>"wordspacing"</literal> comme second paramètre.</entry> - </row> - <row> - <entry><function>pdf_set_transition</function></entry> - <entry><function>pdf_set_parameter</function> en passant - <literal>"transition"</literal> comme second paramètre.</entry> - </row> - <row> - <entry><function>pdf_open</function></entry> - <entry><function>pdf_new</function> suivie d'un appel à - <function>pdf_open_file</function></entry> - </row> - <row> - <entry><function>pdf_set_font</function></entry> - <entry><function>pdf_findfont</function> suivie d'un appel à - <function>pdf_setfont</function></entry> - </row> - <row> - <entry><function>pdf_set_duration</function></entry> - <entry><function>pdf_set_value</function> en passant - <literal>"duration"</literal> comme second paramètre.</entry> - </row> - <row> - <entry><function>pdf_open_gif</function></entry> - <entry><function>pdf_open_image_file</function> en passant - <literal>"gif"</literal> comme second paramètre.</entry> - </row> - <row> - <entry><function>pdf_open_jpeg</function></entry> - <entry><function>pdf_open_image_file</function> en passant - <literal>"jpeg"</literal> comme second paramètre.</entry> - </row> - <row> - <entry><function>pdf_open_tiff</function></entry> - <entry><function>pdf_open_image_file</function> en passant - <literal>"tiff"</literal> comme second paramètre.</entry> - </row> - <row> - <entry><function>pdf_open_png</function></entry> - <entry><function>pdf_open_image_file</function> en passant - <literal>"png"</literal> comme second paramètre.</entry> - </row> - <row> - <entry><function>pdf_get_image_width</function></entry> - <entry><function>pdf_get_value</function> en passant - <literal>"imagewidth"</literal> comme second paramètre et l'image - en troisième paramètre.</entry> - </row> - <row> - <entry><function>pdf_get_image_height</function></entry> - <entry><function>pdf_get_value</function> en passant - <literal>"imageheight"</literal> comme second paramètre et l'image - en troisième paramètre.</entry> - </row> - </tbody> - </tgroup> - </table> + Cette extension a été déplacée dans <ulink url="&url.pecl;">PECL</ulink> + depuis &php; 4.3.9. </para> - </section> + </note> + </section> - <section id="pdf.examples"> - &reftitle.examples; - <simpara> - La plupart des fonctions sont simples d'emploi. Le plus difficile - est probablement de créer un fichier PDF simple. L'exemple suivant - devrait vous mettre sur les rails. - Il crée un fichier <filename>test.pdf</filename> d'une page. - La page contient du texte "Times Roman outlined", d'une taille de 30pt. - Le texte est aussi souligné. - </simpara> - <para> - <example> - <title>Création d'un document PDF avec PDFlib</title> - <programlisting role="php"> + <section id="pdf.requirements"> + &reftitle.required; + <para> + PDFlib est disponible en téléchargement sur + <ulink url="&url.pdf;">&url.pdf;</ulink>, mais impose l'achat + d'une license pour l'utiliser commercialement. + </para> + </section> + + <section id="pdf.oldlibs.hints"> + <title>Problèmes avec les anciennes versions de PDFlib</title> + <para> + Toutes les versions de &php; 4 éditées après le 9 Mars 2000 + ne suportent pas les versions de PDFlib plus anciennes que PDFlib 3.0. + </para> + <para> + PDFlib 4.0 et plus récent est supporté par &php; 4.3 et + plus récent. + </para> + </section> + + &reference.pdf.configure; + + <section id="pdf.resources"> + &reftitle.resources; + &no.resource; + </section> + + <section id="pdf.oldlibs"> + <title>Remarque sur les fonctions obsolètes de la PDFlib</title> + <para> + Depuis &php; 4.0.5, l'extension &php; pour la PDFlib est officiellement + supportée par PDFlib GmbH. Cela signifie que toutes les fonctions décrites + dans le manuel de référence de la PDFlib (PDFlib V3.0 ou supérieur) sont + supportées par &php; 4 avec exactement la même signification et les + mêmes paramètres. Cepdentant, avec la PDFlib V5.0.4 ou supérieure, + tous les paramètres doivent être spécifiés. Pour des raisons de compatibilité, + l'implémentation de la PDFlib supporte la plupart des fonctions obsolètes, mais + elles doivent être remplacées par leur nouvelle version. PDFlib GmbH + ne fournira aucun support pour les problèmes survenant lors de l'utilisation + de ces fonctions obsolètes. La documentation de cette section indique les anciennes fonctions + comme "obsolètes" et donne la fonction qui doit être utilisée à la place. + </para> + </section> + + <section id="pdf.examples"> + &reftitle.examples; + <para> + La plupart des fonctions sont simples d'emploi. Le plus difficile + est probablement de créer un fichier PDF simple. L'exemple suivant + devrait vous mettre sur les rails. Il est développé en &php; 4 et + crée un fichier <filename>hello.pdf</filename> d'une page. + Il définit quelques champs de contenu et charge la police + <literal>Helvetica-Bold</literal> et affiche le texte "Bonjour le monde (dit PHP) !". + </para> + <para> + <example> + <title>Exemple "Bonjour le monde !" avec PDFlib en &php; 4</title> + <programlisting role="php"> <![CDATA[ <?php -$pdf = pdf_new(); -pdf_open_file($pdf, "test.pdf"); -pdf_set_info($pdf, "Author", "Uwe Steinmann"); -pdf_set_info($pdf, "Title", "Test for PHP wrapper of PDFlib 2.0"); -pdf_set_info($pdf, "Creator", "See Author"); -pdf_set_info($pdf, "Subject", "Testing"); -pdf_begin_page($pdf, 595, 842); -pdf_add_outline($pdf, "Page 1"); -$font = pdf_findfont($pdf, "Times New Roman", "winansi", 1); -pdf_setfont($pdf, $font, 10); -pdf_set_value($pdf, "textrendering", 1); -pdf_show_xy($pdf, "Times Roman outlined", 50, 750); -pdf_moveto($pdf, 50, 740); -pdf_lineto($pdf, 330, 740); -pdf_stroke($pdf); -pdf_end_page($pdf); -pdf_close($pdf); -pdf_delete($pdf); -echo '<a href="getpdf.php">terminé</a>'; -?> -]]> - </programlisting> - <para> - Le script <filename>getpdf.php</filename> ne fait que retourner - le document PDF. - </para> - </example> - <example> - <title>Affichage d'un PDF précalculé</title> - <programlisting role="php"> -<![CDATA[ -<?php -$len = filesize($filename); +$p = PDF_new(); + +/* Ouvre un nouveau fichier PDF ; insère un nom de fichier pour créer le PDF sur le disque */ +if (PDF_begin_document($p, "", "") == 0) { + die("Erreur : " . PDF_get_errmsg($p)); +} + +PDF_set_info($p, "Creator", "hello.php"); +PDF_set_info($p, "Author", "Rainer Schaaf"); +PDF_set_info($p, "Title", "Bonjour le monde (PHP) !"); + +PDF_begin_page_ext($p, 595, 842, ""); + +$font = PDF_load_font($p, "Helvetica-Bold", "winansi", ""); + +PDF_setfont($p, $font, 24.0); +PDF_set_text_pos($p, 50, 700); +PDF_show($p, "Bonjour le monde "); +PDF_continue_text($p, "(dit PHP) !"); +PDF_end_page_ext($p, ""); + +PDF_end_document($p, ""); + +$buf = PDF_get_buffer($p); +$len = strlen($buf); + header("Content-type: application/pdf"); header("Content-Length: $len"); -header("Content-Disposition: inline; filename=foo.pdf"); -readfile($filename); +header("Content-Disposition: inline; filename=hello.pdf"); +print $buf; + +PDF_delete($p); ?> ]]> - </programlisting> - </example> - </para> - <para> - La distribution de la PDFlib contient des exemples plus complexes, - qui créent une page avec une horloge à aiguille. Ici, nous utilisons - la création de pages en mémoire, pour éviter l'utilisation de - fichiers temporaires. L'exemple a été adapté à &php;. - (Cet exemple est disponible dans la documentation - <link linkend="ref.cpdf">CLibPDF</link>.) - </para> - <para> - <example> - <title>Exemple pdfclock de PDFlib</title> - <programlisting role="php"> + </programlisting> + </example> + </para> + <para> + L'exemple suivant vient avec la distribution de la PDFlib pour &php; 5. + Il utilise le nouveau gestionnaire d'exceptions ainsi que les nouvelles fonctionnalités + objets disponible en &php; 5. Il crée le fichier <filename>hello.pdf</filename> + d'une seule page. Il définit quelques champs de contenu et charge la police + <literal>Helvetica-Bold</literal> et affiche le texte "Bonjour le monde (dit PHP) !". + </para> + <para> + <example> + <title>Exemple "Bonjour le monde !" avec PDFlib en &php; 5</title> + <programlisting role="php"> <![CDATA[ <?php -$radius = 200; -$margin = 20; -$pagecount = 10; - -$pdf = pdf_new(); - -if (!pdf_open_file($pdf, "")) { - echo error; - exit; -}; - -pdf_set_parameter($pdf, "warning", "true"); - -pdf_set_info($pdf, "Creator", "pdf_clock.php"); -pdf_set_info($pdf, "Author", "Uwe Steinmann"); -pdf_set_info($pdf, "Title", "Analog Clock"); - -while ($pagecount-- > 0) { - pdf_begin_page($pdf, 2 * ($radius + $margin), 2 * ($radius + $margin)); - - pdf_set_parameter($pdf, "transition", "wipe"); - pdf_set_value($pdf, "duration", 0.5); - - pdf_translate($pdf, $radius + $margin, $radius + $margin); - pdf_save($pdf); - pdf_setrgbcolor($pdf, 0.0, 0.0, 1.0); - - /* les marques des minutes */ - pdf_setlinewidth($pdf, 2.0); - for ($alpha = 0; $alpha < 360; $alpha += 6) { - pdf_rotate($pdf, 6.0); - pdf_moveto($pdf, $radius, 0.0); - pdf_lineto($pdf, $radius-$margin/3, 0.0); - pdf_stroke($pdf); - } - pdf_restore($pdf); - pdf_save($pdf); +try { + $p = new PDFlib(); - /* les marques des 5 minutes */ - pdf_setlinewidth($pdf, 3.0); - for ($alpha = 0; $alpha < 360; $alpha += 30) { - pdf_rotate($pdf, 30.0); - pdf_moveto($pdf, $radius, 0.0); - pdf_lineto($pdf, $radius-$margin, 0.0); - pdf_stroke($pdf); + /* Ouvre un nouveau fichier PDF ; insère un nom de fichier pour créer le PDF sur le disque */ + if ($p->begin_document("", "") == 0) { + die("Erreur : " . $p->get_errmsg()); } - $ltime = getdate(); - - /* l'aiguille des heures */ - pdf_save($pdf); - pdf_rotate($pdf,-(($ltime['minutes']/60.0)+$ltime['hours']-3.0)*30.0); - pdf_moveto($pdf, -$radius/10, -$radius/20); - pdf_lineto($pdf, $radius/2, 0.0); - pdf_lineto($pdf, -$radius/10, $radius/20); - pdf_closepath($pdf); - pdf_fill($pdf); - pdf_restore($pdf); - - /* l'aiguille des minutes */ - pdf_save($pdf); - pdf_rotate($pdf,-(($ltime['seconds']/60.0)+$ltime['minutes']-15.0)*6.0); - pdf_moveto($pdf, -$radius/10, -$radius/20); - pdf_lineto($pdf, $radius * 0.8, 0.0); - pdf_lineto($pdf, -$radius/10, $radius/20); - pdf_closepath($pdf); - pdf_fill($pdf); - pdf_restore($pdf); - - /* l'aiguille des secondes */ - pdf_setrgbcolor($pdf, 1.0, 0.0, 0.0); - pdf_setlinewidth($pdf, 2); - pdf_save($pdf); - pdf_rotate($pdf, -(($ltime['seconds'] - 15.0) * 6.0)); - pdf_moveto($pdf, -$radius/5, 0.0); - pdf_lineto($pdf, $radius, 0.0); - pdf_stroke($pdf); - pdf_restore($pdf); - - /* Dessin d'un petit cercle dans le centre */ - pdf_circle($pdf, 0, 0, $radius/30); - pdf_fill($pdf); + $p->set_info("Creator", "hello.php"); + $p->set_info("Author", "Rainer Schaaf"); + $p->set_info("Title", "Bonjour le monde (PHP) !"); - pdf_restore($pdf); + $p->begin_page_ext(595, 842, ""); - pdf_end_page($pdf); + $font = $p->load_font("Helvetica-Bold", "winansi", ""); - // pour voir la différence - sleep(1); -} + $p->setfont($font, 24.0); + $p->set_text_pos(50, 700); + $p->show("Bonjour le monde "); + $p->continue_text("(dit PHP) !"); + $p->end_page_ext(""); -pdf_close($pdf); + $p->end_document(""); -$buf = pdf_get_buffer($pdf); -$len = strlen($buf); + $buf = $p->get_buffer(); + $len = strlen($buf); -header("Content-type: application/pdf"); -header("Content-Length: $len"); -header("Content-Disposition: inline; filename=foo.pdf"); -echo $buf; - -pdf_delete($pdf); + header("Content-type: application/pdf"); + header("Content-Length: $len"); + header("Content-Disposition: inline; filename=hello.pdf"); + print $buf; +} +catch (PDFlibException $e) { + die("Une exception PDFlib est survenu dans l'exemple hello :\n" . + "[" . $e->get_errnum() . "] " . $e->get_apiname() . ": " . + $e->get_errmsg() . "\n"); +} +catch (Exception $e) { + die($e); +} +$p = 0; ?> ]]> - </programlisting> - </example> - </para> - </section> + </programlisting> + </example> + </para> + </section> - <section id="pdf.seealso"> - &reftitle.seealso; - <note> - <para> - Une alternative au module module PDFlib est le module - de <ulink url="&url.cpdf;">FastIO</ulink> : ClibPDF. Voyez la - section <link linkend="ref.cpdf">ClibPDF</link> - pour plus de détails. Notez que <link linkend="ref.cpdf">ClibPDF</link> - disponse d'une API différente de PDFlib. - </para> - </note> - </section> + </partintro> - </partintro> + &reference.pdf.functions; -&reference.pdf.functions; +</reference> - </reference> <!-- Keep this comment at the end of the file Local variables: mode: sgml @@ -477,5 +253,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/viewcvs.cgi/phpdoc-fr/reference/regex/functions/split.xml?r1=1.16&r2=1.17&diff_format=u Index: phpdoc-fr/reference/regex/functions/split.xml diff -u phpdoc-fr/reference/regex/functions/split.xml:1.16 phpdoc-fr/reference/regex/functions/split.xml:1.17 --- phpdoc-fr/reference/regex/functions/split.xml:1.16 Thu May 5 16:04:34 2005 +++ phpdoc-fr/reference/regex/functions/split.xml Fri Dec 16 15:16:37 2005 @@ -1,73 +1,74 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.16 $ --> -<!-- EN-Revision: 1.5 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.17 $ --> +<!-- EN-Revision: 1.6 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> - <refentry id="function.split"> - <refnamediv> - <refname>split</refname> - <refpurpose> - Scinde une chaîne en un tableau, grâce à une expression rationnelle - </refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>array</type><methodname>split</methodname> - <methodparam><type>string</type><parameter>pattern</parameter></methodparam> - <methodparam><type>string</type><parameter>string</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>limit</parameter></methodparam> - </methodsynopsis> - <tip> - <para> - <function>preg_split</function>, qui utilise la syntaxe des expressions rationnelles - compatibles PERL, est une alternative plus rapide à <function>split</function>. - Si vous n'avez pas besoin de la puissance des expressions rationnelles, il est plus - rapide d'utiliser <function>explode</function>, qui n'utilise pas le moteur - d'expressions rationnelles. - </para> - </tip> - <para> - <function>split</function> retourne un tableau de chaînes : - chacune d'entre elle est une sous-chaîne de - <parameter>string</parameter> délimitée par les - occurrences trouvées de l'expression rationnelle - <parameter>pattern</parameter>. Si <parameter>limit</parameter> - est défini, le tableau retourné contiendra un maximum de - <parameter>limit</parameter> éléments avec le dernier élément contenant - le reste de la chaîne <parameter>string</parameter>. - Si une erreur survient, retourne - &false;. - </para> - <para> - Pour lire les 5 premiers champs d'une ligne du fichier - <filename>/etc/passwd</filename>: - <example> - <title>Exemple avec <function>split</function></title> - <programlisting role="php"> + +<refentry id="function.split"> + <refnamediv> + <refname>split</refname> + <refpurpose> + Scinde une chaîne en un tableau, grâce à une expression rationnelle + </refpurpose> + </refnamediv> + <refsect1> + &reftitle.description; + <methodsynopsis> + <type>array</type><methodname>split</methodname> + <methodparam><type>string</type><parameter>pattern</parameter></methodparam> + <methodparam><type>string</type><parameter>string</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>limit</parameter></methodparam> + </methodsynopsis> + <tip> + <para> + <function>preg_split</function>, qui utilise la syntaxe des expressions rationnelles + compatibles PERL, est une alternative plus rapide à <function>split</function>. + Si vous n'avez pas besoin de la puissance des expressions rationnelles, il est plus + rapide d'utiliser <function>explode</function>, qui n'utilise pas le moteur + d'expressions rationnelles. + </para> + </tip> + <para> + <function>split</function> retourne un tableau de chaînes : + chacune d'entre elle est une sous-chaîne de + <parameter>string</parameter> délimitée par les + occurrences trouvées de l'expression rationnelle + <parameter>pattern</parameter>. Si <parameter>limit</parameter> + est défini, le tableau retourné contiendra un maximum de + <parameter>limit</parameter> éléments avec le dernier élément contenant + le reste de la chaîne <parameter>string</parameter>. + Si une erreur survient, retourne + &false;. + </para> + <para> + Pour lire les 5 premiers champs d'une ligne du fichier + <filename>/etc/passwd</filename>: + <example> + <title>Exemple avec <function>split</function></title> + <programlisting role="php"> <![CDATA[ <?php list($user, $pass, $uid, $gid, $extra)= split (":", $passwd_line, 5); ?> ]]> - </programlisting> - </example> - </para> - <simpara> - S'il y a <replaceable>n</replaceable> occurrences de - <parameter>pattern</parameter>, le tableau retourné - contiendra <literal><replaceable>n</replaceable>+1</literal> éléments. - Par exemple, s'il n'y a aucune occurrence de <parameter>pattern</parameter>, - un tableau d'un seul élément sera retourné. Bien sûr, cela reste vrai - si <parameter>string</parameter> est une chaîne vide. - </simpara> - <para> - Pour analyser une date qui est délimitée par des /, - des points ou des tirets : - </para> - <para> - <example> - <title>Exemple avec <function>split</function></title> - <programlisting role="php"> + </programlisting> + </example> + </para> + <simpara> + S'il y a <replaceable>n</replaceable> occurrences de + <parameter>pattern</parameter>, le tableau retourné + contiendra <literal><replaceable>n</replaceable>+1</literal> éléments. + Par exemple, s'il n'y a aucune occurrence de <parameter>pattern</parameter>, + un tableau d'un seul élément sera retourné. Bien sûr, cela reste vrai + si <parameter>string</parameter> est une chaîne vide. + </simpara> + <para> + Pour analyser une date qui est délimitée par des /, + des points ou des tirets : + </para> + <para> + <example> + <title>Exemple avec <function>split</function></title> + <programlisting role="php"> <![CDATA[ <?php // Les délimiteurs peuvent être des tirets, points ou slash @@ -76,37 +77,39 @@ echo "Month: $month; Day: $day; Year: $year<br />\n"; ?> ]]> - </programlisting> - </example> - </para> - <para> - Pour les utilisateurs qui recherchent le moyen d'émuler - la commande Perl <command>@chars = split('', $str)</command>, - voyez <function>preg_split</function>. - </para> - <para> - Notez aussi que <parameter>pattern</parameter> est une - expression rationnelle. Si vous voulez utiliser - n'importe quel caractère spécial des expressions - rationnelles, vous devez les échapper. Si vous - pensez que <function>split</function> (ou toute autre expression - rationnelle) se comporte bizarrement, lisez d'abord - le fichier <filename>regex.7</filename>, inclus dans le dossier - <filename>regex/</filename> de la distribution &php; . Il est au - format manpage, et vous pourrez le lire avec une commande telle que - <command>man /usr/local/src/regex/regex.7</command>. - </para> - <para> - Voir aussi - <function>preg_split</function>, - <function>spliti</function>, - <function>explode</function>, - <function>implode</function>, - <function>chunk_split</function> et - <function>wordwrap</function>. - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + <para> + Pour les utilisateurs qui recherchent le moyen d'émuler + la commande Perl <command>@chars = split('', $str)</command>, + voyez la fonction <function>preg_split</function> ou + la fonction <function>str_split</function>. + </para> + <para> + Notez aussi que <parameter>pattern</parameter> est une + expression rationnelle. Si vous voulez utiliser + n'importe quel caractère spécial des expressions + rationnelles, vous devez les échapper. Si vous + pensez que <function>split</function> (ou toute autre expression + rationnelle) se comporte bizarrement, lisez d'abord + le fichier <filename>regex.7</filename>, inclus dans le dossier + <filename>regex/</filename> de la distribution &php; . Il est au + format manpage, et vous pourrez le lire avec une commande telle que + <command>man /usr/local/src/regex/regex.7</command>. + </para> + <para> + Voir aussi + <function>preg_split</function>, + <function>spliti</function>, + <function>str_split</function>, + <function>explode</function>, + <function>implode</function>, + <function>chunk_split</function> et + <function>wordwrap</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -127,4 +130,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