annotate vendor/psy/psysh/src/Exception/BreakException.php @ 19:fa3358dc1485 tip

Add ndrum files
author Chris Cannam
date Wed, 28 Aug 2019 13:14:47 +0100
parents 129ea1e6d783
children
rev   line source
Chris@13 1 <?php
Chris@13 2
Chris@13 3 /*
Chris@13 4 * This file is part of Psy Shell.
Chris@13 5 *
Chris@13 6 * (c) 2012-2018 Justin Hileman
Chris@13 7 *
Chris@13 8 * For the full copyright and license information, please view the LICENSE
Chris@13 9 * file that was distributed with this source code.
Chris@13 10 */
Chris@13 11
Chris@13 12 namespace Psy\Exception;
Chris@13 13
Chris@13 14 /**
Chris@13 15 * A break exception, used for halting the Psy Shell.
Chris@13 16 */
Chris@13 17 class BreakException extends \Exception implements Exception
Chris@13 18 {
Chris@13 19 private $rawMessage;
Chris@13 20
Chris@13 21 /**
Chris@13 22 * {@inheritdoc}
Chris@13 23 */
Chris@13 24 public function __construct($message = '', $code = 0, \Exception $previous = null)
Chris@13 25 {
Chris@13 26 $this->rawMessage = $message;
Chris@17 27 parent::__construct(\sprintf('Exit: %s', $message), $code, $previous);
Chris@13 28 }
Chris@13 29
Chris@13 30 /**
Chris@13 31 * Return a raw (unformatted) version of the error message.
Chris@13 32 *
Chris@13 33 * @return string
Chris@13 34 */
Chris@13 35 public function getRawMessage()
Chris@13 36 {
Chris@13 37 return $this->rawMessage;
Chris@13 38 }
Chris@13 39
Chris@13 40 /**
Chris@13 41 * Throws BreakException.
Chris@13 42 *
Chris@13 43 * Since `throw` can not be inserted into arbitrary expressions, it wraps with function call.
Chris@13 44 *
Chris@13 45 * @throws BreakException
Chris@13 46 */
Chris@13 47 public static function exitShell()
Chris@13 48 {
Chris@13 49 throw new self('Goodbye');
Chris@13 50 }
Chris@13 51 }