From aa2c16f49161acd8e9fcf059c37436ff6acd0e78 Mon Sep 17 00:00:00 2001
From: Hartmut Holzgraefe <hholzgra@php.net>
Date: Tue, 27 Dec 2005 21:12:53 +0000
Subject: [PATCH] added more examples

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@203795 c90b9560-bf6c-de11-be94-00142212c4b1
---
 .../outcontrol/functions/ob-get-contents.xml  | 42 +++++++++++++++++--
 .../outcontrol/functions/ob-get-length.xml    | 37 +++++++++++++++-
 2 files changed, 75 insertions(+), 4 deletions(-)

diff --git a/reference/outcontrol/functions/ob-get-contents.xml b/reference/outcontrol/functions/ob-get-contents.xml
index e963c75cec..2bc66d46f3 100644
--- a/reference/outcontrol/functions/ob-get-contents.xml
+++ b/reference/outcontrol/functions/ob-get-contents.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.2 $ -->
+<!-- $Revision: 1.3 $ -->
 <!-- splitted from ./en/functions/outcontrol.xml, last change in rev 1.5 -->
   <refentry id="function.ob-get-contents">
    <refnamediv>
@@ -15,8 +15,44 @@
       <void/>
      </methodsynopsis>
     <para>
-     This will return the contents of the output buffer or &false;, if
-     output buffering isn't active.
+     This will return the contents of the output buffer without clearing it
+     or &false;, if output buffering isn't active.
+    </para>
+    <para>
+     <example>
+      <title>A simple <function>ob_get_contents</function> example</title>
+      <programlisting role="php">
+<![CDATA[
+<?php
+
+ob_start();
+
+echo "Hello ";
+
+$out1 = ob_get_contents();
+
+echo "World";
+
+$out2 = ob_get_contents();
+
+ob_end_clean();
+
+var_dump($out1, $out2);
+?>
+]]>
+      </programlisting>
+      <para>
+       Our example will output:
+      </para>
+      <screen>
+<![CDATA[
+
+string(6) "Hello "
+string(11) "Hello World"
+
+]]>
+      </screen>
+     </example>
     </para>
     <para>
      See also <function>ob_start</function> and
diff --git a/reference/outcontrol/functions/ob-get-length.xml b/reference/outcontrol/functions/ob-get-length.xml
index 0d9da71ebd..f802512e4b 100644
--- a/reference/outcontrol/functions/ob-get-length.xml
+++ b/reference/outcontrol/functions/ob-get-length.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.3 $ -->
+<!-- $Revision: 1.4 $ -->
 <!-- splitted from ./en/functions/outcontrol.xml, last change in rev 1.22 -->
   <refentry id="function.ob-get-length">
    <refnamediv>
@@ -18,6 +18,41 @@
      This will return the length of the contents in the output buffer
      or &false;, if output buffering isn't active.
     </para>
+    <para>
+     <example>
+      <title>A simple <function>ob_get_contents</function> example</title>
+      <programlisting role="php">
+<![CDATA[
+<?php
+
+ob_start();
+
+echo "Hello ";
+
+$len1 = ob_get_length();
+
+echo "World";
+
+$len2 = ob_get_length();
+
+ob_end_clean();
+
+echo $len1 . ", ." . $len2;
+?>
+]]>
+      </programlisting>
+      <para>
+       Our example will output:
+      </para>
+      <screen>
+<![CDATA[
+
+6, 11
+
+]]>
+      </screen>
+     </example>
+    </para>
     <para>
      See also <function>ob_start</function> and
      <function>ob_get_contents</function>.