Re: svn: /phpdoc/en/trunk/language/ exceptions.xml
| From: | Richard Quadling | Date: | Thu, 03 Sep 2009 10:06:40 +0000 |
| Subject: | Re: svn: /phpdoc/en/trunk/language/ exceptions.xml | ||
| References: | 1 2 | Groups: | php.doc.cvs |
| Request: | Send a blank email to doc-cvs+get-4821@lists.php.net to get a copy of this message | ||
2009/9/2 Hannes Magnusson <hannes.magnusson@gmail.com>:
> On Tue, Sep 1, 2009 at 12:20, Richard Quadling<rquadling@php.net> wrote:
>> rquadling Tue, 01 Sep 2009 10:20:56 +0000
>>
>> Revision:
>> http://svn.php.net/viewvc?view=revision&revision=287937
>>
>> Log:
>> Missing properties and methods of the built-in Exception class and note regarding the
>> inability to clone an Exception.
>> Fixes bug #49402
>>
>> Bug: http://bugs.php.net/49402 (Open) Documentation for
>> extending Exception is outdated
>>
>> Changed paths:
>> U phpdoc/en/trunk/language/exceptions.xml
>>
>> Modified: phpdoc/en/trunk/language/exceptions.xml
>> ===================================================================
>> --- phpdoc/en/trunk/language/exceptions.xml 2009-09-01 08:42:10 UTC (rev 287936)
>> +++ phpdoc/en/trunk/language/exceptions.xml 2009-09-01 10:20:56 UTC (rev 287937)
>> @@ -125,21 +125,27 @@
>> class Exception
>> {
>> protected $message = 'Unknown exception'; // exception message
>> + private $string; // __toString cache
>> protected $code = 0; // user defined exception
>> code
>> protected $file; // source filename of
>> exception
>> protected $line; // source line of exception
>> + private $trace; // backtrace
>> + private $previous; // previous exception if
>> nested exception
>>
>> - function __construct($message = null, $code = 0);
>> + public function __construct($message = null, $code = 0, Exception $previous = null);
>>
>> - final function getMessage(); // message of exception
>> - final function getCode(); // code of exception
>> - final function getFile(); // source filename
>> - final function getLine(); // source line
>> - final function getTrace(); // an array of the backtrace()
>> - final function getTraceAsString(); // formatted string of trace
>> + final private function __clone(); // Inhibits cloning of exceptions.
>>
>> + final public function getMessage(); // message of exception
>> + final public function getCode(); // code of exception
>> + final public function getFile(); // source filename
>> + final public function getLine(); // source line
>> + final public function getTrace(); // an array of the backtrace()
>> + final public function getPrevious(); // previous exception
>> + final public function getTraceAsString(); // formatted string of trace
>> +
>> /* Overrideable */
>> - function __toString(); // formatted string for
>> display
>> + public function __toString(); // formatted string for display
>> }
>
>
> Should we maybe remove this?
> This is already documented on http://php.net/class.exception
>
> -Hannes
>
> --
> PHP Documentation Commits Mailing List (http://www.php.net/)
> To unsubscribe, visit: http://www.php.net/unsub.php
>
>
Well that seems like a pointless commit on my behalf.
Yeah. Linking to the class.exception is obviously a much easier
option, though for readability, having it on the page about extending
the class does have merit.
--
-----
Richard Quadling
"Standing on the shoulders of some very clever giants!"
EE : http://www.experts-exchange.com/M_248814.html
Zend Certified Engineer : http://zend.com/zce.php?c=ZEND002498&r=213474731
ZOPA : http://uk.zopa.com/member/RQuadling