Re: svn: /phpdoc/en/trunk/language/ exceptions.xml

From: 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

« previous php.doc.cvs (#4821) next »