[PHP-DOC] cvs: phpdoc /fr/functions outcontrol.xml From: Damien Seguy (dams <email protected>)
Date: 11/13/00

dams Mon Nov 13 01:52:33 2000 EDT

  Modified files:
    /phpdoc/fr/functions outcontrol.xml
  Log:
  Added Callback function with ob_start
  
Index: phpdoc/fr/functions/outcontrol.xml
diff -u phpdoc/fr/functions/outcontrol.xml:1.4 phpdoc/fr/functions/outcontrol.xml:1.5
--- phpdoc/fr/functions/outcontrol.xml:1.4 Thu Nov 9 04:46:52 2000
+++ phpdoc/fr/functions/outcontrol.xml Mon Nov 13 01:52:32 2000
@@ -92,7 +92,11 @@
     <funcsynopsis>
      <funcprototype>
       <funcdef>void <function>ob_start</function></funcdef>
- <void/>
+ <paramdef>string
+ <parameter>
+ <optional>output_callback</optional>
+ </parameter>
+ </paramdef>
      </funcprototype>
     </funcsynopsis>
     <para>
@@ -106,6 +110,51 @@
      contenu de ce buffer, utilisez <function>ob_end_flush</function>. Au
      contraire, <function>ob_end_clean</function> effacera le contenu de ce buffer.
     </para>
+ <para>
+ Une fonction optionnelle de callback peut tre spŽcifiŽe en
+ troisime argument. Cette fonction prend une cha”ne comme
+ paramtre, et retourne une cha”ne. Elle sera appelŽe par
+ <function>ob_end_flush</function> et recevra le cotenu du
+ buffer de sortie. Elle doit retourner un nouveau contenu
+ pour le buffer de sortie : celui ci sera envoyŽ ˆ la sortie
+ standard.
+ </para>
+ <para>
+ Les buffers de sortie sont gŽrŽs par pile, c'est ˆ dire que
+ vous pouvez appeler plusieurs <function>ob_start</function>
+ simultanŽment. Assurez-vous que vous appelez
+ <function>ob_end_flush</function> suffisamment souvent.
+ Si plusieurs fonctions de callback sont actives, les
+ contenus seront filtrŽs sŽquentiellement, dans l'ordre
+ d'embo”tement.
+ </para>
+ <example>
+ <title>Exemple de callback</title>
+ <programlisting role="php">
+&lt;?php
+function c($str) {
+ // Aa claar da la lana, man ama Paarrat..
+ return nl2br(ereg_replace("[aeiou]", "u", $str));
+}
+
+function d($str) {
+ return strip_tags($str);
+}
+?>
+
+&lt;?php ob_start("c"); ?&gt;
+Au clair de la lune, mon ami Pierrot
+&lt;?php ob_start("d"); ?&gt;
+&lt;h1&gt;..Prete moi ta plume, pour ecrire un mot...&lt;/h1&gt;
+&lt;?php ob_end_flush(); ?&gt;
+... Ma chandelle est morte, je n'ai plus de feu
+&lt;?php ob_end_flush(); ?&gt;
+... Ouvre moi la porte, pour l'amour de Dieu
+&lt;?php ob_end_flush(); ?&gt;
+
+?&gt;
+ </programlisting>
+ </example>
     <para>
      Voir aussi <function>ob_get_contents</function>,<function>ob_end_flush</function>,
      <function>ob_end_clean</function>, et <function>ob_implicit_flush</function>