From 68c526733467509c7f7fb756cd01eac6ff5da0b4 Mon Sep 17 00:00:00 2001
From: Daniel Egeberg <degeberg@php.net>
Date: Wed, 20 Jan 2010 11:41:23 +0000
Subject: [PATCH] Fixed PHP bug #50798 (Unable to retrieve default value of
 argument of internal method with reflection) and added example to
 ReflectionParameter::getDefaultValue().

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@293765 c90b9560-bf6c-de11-be94-00142212c4b1
---
 .../reflectionparameter/getdefaultvalue.xml   | 56 +++++++++++++++++--
 1 file changed, 52 insertions(+), 4 deletions(-)

diff --git a/reference/reflection/reflectionparameter/getdefaultvalue.xml b/reference/reflection/reflectionparameter/getdefaultvalue.xml
index b94b15179c..8e9fa1d325 100644
--- a/reference/reflection/reflectionparameter/getdefaultvalue.xml
+++ b/reference/reflection/reflectionparameter/getdefaultvalue.xml
@@ -14,11 +14,10 @@
    <void />
   </methodsynopsis>
   <para>
-   Gets the parameters default value.
+   Gets the default value of the parameter for a user-defined function or method.
+   If the parameter is not optional a <classname>ReflectionException</classname>
+   will be thrown.
   </para>
-
-  &warn.undocumented.func;
-
  </refsect1>
 
  <refsect1 role="parameters">
@@ -32,6 +31,55 @@
    The parameters default value.
   </para>
  </refsect1>
+ 
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <para>
+   <example>
+    <title>Getting </title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+function foo($test, $bar = 'baz')
+{
+    echo $test . $bar;
+}
+
+$function = new ReflectionFunction('foo');
+
+foreach ($function->getParameters() as $param) {
+    echo 'Name: ' . $param->getName() . PHP_EOL;
+    if ($param->isOptional()) {
+        echo 'Default value: ' . $param->getDefaultValue() . PHP_EOL;
+    }
+    echo PHP_EOL;
+}
+?>
+]]>
+    </programlisting>
+    &example.outputs;
+   <screen>
+<![CDATA[
+Name: test
+
+Name: bar
+Default value: baz
+]]>
+   </screen>
+   </example>
+  </para>
+ </refsect1>
+ 
+ <refsect1 role="notes">
+  &reftitle.notes;
+  <note>
+   <para>
+    Due to implementation details, it is not possible to get the default value
+    of built-in functions or methods of built-in classes. Trying to do this will
+    result a <classname>ReflectionException</classname> being thrown.
+   </para>
+  </note>
+ </refsect1>
 
  <refsect1 role="seealso">
   &reftitle.seealso;