From ccdc549169e5cd40a94a5d0cdee587aeaf04f548 Mon Sep 17 00:00:00 2001
From: Levi Morrison <levim@php.net>
Date: Tue, 13 Dec 2011 20:37:12 +0000
Subject: [PATCH] Added the exceptions thrown when you call SplHeap::extract,
 SplHeap::top, and SplObjectStorage::offsetGet.

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@320973 c90b9560-bf6c-de11-be94-00142212c4b1
---
 reference/spl/splheap/extract.xml            | 7 +++++++
 reference/spl/splheap/top.xml                | 7 +++++++
 reference/spl/splobjectstorage/offsetget.xml | 9 ++++++++-
 3 files changed, 22 insertions(+), 1 deletion(-)

diff --git a/reference/spl/splheap/extract.xml b/reference/spl/splheap/extract.xml
index cf004378b9..53930118c3 100644
--- a/reference/spl/splheap/extract.xml
+++ b/reference/spl/splheap/extract.xml
@@ -25,6 +25,13 @@
    The value of the extracted node.
   </para>
  </refsect1>
+ 
+ <refsect1 role="errors"><!-- {{{ -->
+  &reftitle.errors;
+  <para>
+   Throws <classname>RuntimeException</classname> when the data-structure is empty.
+  </para>
+ </refsect1><!-- }}} -->
 
 </refentry>
 
diff --git a/reference/spl/splheap/top.xml b/reference/spl/splheap/top.xml
index d80e032f72..75d6f7ad71 100644
--- a/reference/spl/splheap/top.xml
+++ b/reference/spl/splheap/top.xml
@@ -26,6 +26,13 @@
   </para>
  </refsect1>
 
+ <refsect1 role="errors"><!-- {{{ -->
+  &reftitle.errors;
+  <para>
+   Throws <classname>RuntimeException</classname> when the data-structure is empty.
+  </para>
+ </refsect1><!-- }}} -->
+ 
 </refentry>
 
 <!-- Keep this comment at the end of the file
diff --git a/reference/spl/splobjectstorage/offsetget.xml b/reference/spl/splobjectstorage/offsetget.xml
index 3f2d28f38d..9df0fb9cd4 100644
--- a/reference/spl/splobjectstorage/offsetget.xml
+++ b/reference/spl/splobjectstorage/offsetget.xml
@@ -40,7 +40,14 @@
    The data previously associated with the <type>object</type> in the storage.
   </para>
  </refsect1>
-
+ 
+ <refsect1 role="errors"><!-- {{{ -->
+  &reftitle.errors;
+  <para>
+   Throws <classname>UnexpectedValueException</classname> when <parameter>object</parameter> could not be found.
+  </para>
+ </refsect1><!-- }}} -->
+ 
  <refsect1 role="examples">
   &reftitle.examples;
   <para>