From 413b0c132afa0d5e2eb1f4f7c07d133e4e4a2670 Mon Sep 17 00:00:00 2001
From: Felipe Pena <felipe@php.net>
Date: Fri, 10 Oct 2008 18:12:54 +0000
Subject: [PATCH] - Added examples

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@267159 c90b9560-bf6c-de11-be94-00142212c4b1
---
 reference/strings/functions/vprintf.xml  | 18 ++++++++++++-
 reference/strings/functions/vsprintf.xml | 18 ++++++++++++-
 reference/var/functions/gettype.xml      | 34 +++++++++++++++++++++++-
 reference/var/functions/is-null.xml      | 29 +++++++++++++++++++-
 4 files changed, 95 insertions(+), 4 deletions(-)

diff --git a/reference/strings/functions/vprintf.xml b/reference/strings/functions/vprintf.xml
index b7ca2b410b..dee7e3ba3d 100644
--- a/reference/strings/functions/vprintf.xml
+++ b/reference/strings/functions/vprintf.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.8 $ -->
+<!-- $Revision: 1.9 $ -->
 <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.vprintf">
  <refnamediv>
   <refname>vprintf</refname>
@@ -54,6 +54,22 @@
    Returns the length of the outputted string.
   </para>
  </refsect1>
+ 
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <para>
+   <example>
+    <title><function>vprintf</function>: zero-padded integers</title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+vprintf("%04d-%02d-%02d", explode('-', '1988-8-1')); // 1988-08-01
+?>
+]]>
+    </programlisting>
+   </example>
+  </para>
+ </refsect1>
 
  <refsect1 role="seealso">
   &reftitle.seealso;
diff --git a/reference/strings/functions/vsprintf.xml b/reference/strings/functions/vsprintf.xml
index 1d78ee6000..fc4bc772ae 100644
--- a/reference/strings/functions/vsprintf.xml
+++ b/reference/strings/functions/vsprintf.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.8 $ -->
+<!-- $Revision: 1.9 $ -->
 <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.vsprintf">
  <refnamediv>
   <refname>vsprintf</refname>
@@ -51,6 +51,22 @@
    for <function>sprintf</function>).
   </para>
  </refsect1>
+ 
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <para>
+   <example>
+    <title><function>vsprintf</function>: zero-padded integers</title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+print vsprintf("%04d-%02d-%02d", explode('-', '1988-8-1')); // 1988-08-01
+?>
+]]>
+    </programlisting>
+   </example>
+  </para>
+ </refsect1>
 
  <refsect1 role="seealso">
   &reftitle.seealso;
diff --git a/reference/var/functions/gettype.xml b/reference/var/functions/gettype.xml
index 8f7bbe63fd..0da55843ec 100644
--- a/reference/var/functions/gettype.xml
+++ b/reference/var/functions/gettype.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.11 $ -->
+<!-- $Revision: 1.12 $ -->
 <refentry xml:id="function.gettype" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>gettype</refname>
@@ -99,6 +99,38 @@
    </itemizedlist>
   </para>
  </refsect1>
+ 
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <para>
+   <example>
+    <title><function>gettype</function> example</title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+
+$data = array(1, 1., NULL, new stdClass, 'foo');
+
+foreach ($data as $value) {
+    echo gettype($value), "\n";
+}
+
+?>
+]]>
+    </programlisting>
+    &example.outputs.similar;
+    <screen>
+<![CDATA[
+integer
+double
+NULL
+object
+string
+]]>
+    </screen>
+   </example>
+  </para>
+ </refsect1>
 
  <refsect1 role="seealso">
   &reftitle.seealso;
diff --git a/reference/var/functions/is-null.xml b/reference/var/functions/is-null.xml
index b09aa26e69..848f6a6ff3 100644
--- a/reference/var/functions/is-null.xml
+++ b/reference/var/functions/is-null.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.8 $ -->
+<!-- $Revision: 1.9 $ -->
 <refentry xml:id="function.is-null" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>is_null</refname>
@@ -39,6 +39,33 @@
    otherwise.
   </para>
  </refsect1>
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <para>
+   <example>
+    <title><function>is_null</function> example</title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+
+error_reporting(E_ALL);
+
+$foo = NULL;
+var_dump(is_null($inexistent), is_null($foo));
+
+?>
+]]>
+    </programlisting>
+    <screen>
+<![CDATA[
+Notice: Undefined variable: inexistent in ...
+bool(true)
+bool(true)
+]]>
+    </screen>
+   </example>
+  </para>
+ </refsect1>
  <refsect1 role="seealso">
   &reftitle.seealso;
   <para>