From 9f3031f58a266bfee054b1f5766e184e435922dd Mon Sep 17 00:00:00 2001 From: Arthur Schiwon Date: Mon, 28 Nov 2016 11:34:23 +0100 Subject: [PATCH] add missing phpdoc to HintException Signed-off-by: Arthur Schiwon --- lib/private/HintException.php | 32 ++++++++++++++++++++++++++++++++ 1 file changed, 32 insertions(+) diff --git a/lib/private/HintException.php b/lib/private/HintException.php index 7ff8240afd2..1233fdca148 100644 --- a/lib/private/HintException.php +++ b/lib/private/HintException.php @@ -26,19 +26,51 @@ namespace OC; +/** + * Class HintException + * + * An Exception class with the intention to be presented to the end user + * + * @package OC + */ class HintException extends \Exception { private $hint; + /** + * HintException constructor. + * + * @param string $message The error message. It will be not revealed to the + * the user (unless the hint is empty) and thus + * should be not translated. + * @param string $hint A useful message that is presented to the end + * user. It should be translated, but must not + * contain sensitive data. + * @param int $code + * @param \Exception|null $previous + */ public function __construct($message, $hint = '', $code = 0, \Exception $previous = null) { $this->hint = $hint; parent::__construct($message, $code, $previous); } + /** + * Returns a string representation of this Exception that includes the error + * code, the message and the hint. + * + * @return string + */ public function __toString() { return __CLASS__ . ": [{$this->code}]: {$this->message} ({$this->hint})\n"; } + /** + * Returns the hint with the intention to be presented to the end user. If + * an empty hint was specified upon instatiation, the message is returned + * instead. + * + * @return string + */ public function getHint() { if (empty($this->hint)) { return $this->message; -- 2.39.5