From: Marcus Boerger <helly@php.net>
Date: Sun, 22 Feb 2004 18:50:47 +0000 (+0000)
Subject: Add some more obviously needed information
X-Git-Tag: RELEASE_0_2_0~231
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=1fbe07c9e0a7674710c4ae8eaa380ba1cb94f9d2;p=php

Add some more obviously needed information
---

diff --git a/Zend/ZEND_CHANGES b/Zend/ZEND_CHANGES
index 78b0deb886..1b172eb91e 100644
--- a/Zend/ZEND_CHANGES
+++ b/Zend/ZEND_CHANGES
@@ -596,6 +596,32 @@ Changes in the Zend Engine 2.0
       If you derive your exception classes from this Exception base class
       your exceptions will be nicely shown in the builtin handler for 
       uncaught exceptions.
+      
+      Note: The method getMessage() is a final read only access method to 
+      the private proeprty message that is set in the constructor. If you
+      feel a need to overwrite the exception display then overload method
+      __toString() in your derived class or implement your own extneral 
+      exception display function to accomplish your desired formatting.
+      
+      Example:
+      
+      <?php
+      function display_exception(Exception $ex)
+      {
+          echo 'Exception: ' . $ex->getMessage() . 'with backtrace: <pre>';
+          echo $ex->getTrace();
+          echo '</pre>';
+      }
+      
+      try
+      {
+          // your code here
+      }
+      catch (Exception $ex)
+      {
+          display_exeption($ex);
+      }
+      ?>
 
     * Dereferencing objects returned from functions.