@@ -45,17 +45,17 @@ |
||
45 | 45 | use GanbaroDigital\MissingBits\ListTraversals\TraverseList; |
46 | 46 | use GanbaroDigital\MissingBits\ListTraversals\TraverseObject; |
47 | 47 | |
48 | - /** |
|
49 | - * traverse a list held in an array |
|
50 | - * |
|
51 | - * @param array $list |
|
52 | - * the list to walk |
|
53 | - * @param string $listName |
|
54 | - * what is the name of $list in the calling code? |
|
55 | - * @param callable $callable |
|
56 | - * what are we calling |
|
57 | - * @return void |
|
58 | - */ |
|
48 | + /** |
|
49 | + * traverse a list held in an array |
|
50 | + * |
|
51 | + * @param array $list |
|
52 | + * the list to walk |
|
53 | + * @param string $listName |
|
54 | + * what is the name of $list in the calling code? |
|
55 | + * @param callable $callable |
|
56 | + * what are we calling |
|
57 | + * @return void |
|
58 | + */ |
|
59 | 59 | function traverse_array($list, $listName, callable $callable) |
60 | 60 | { |
61 | 61 | return TraverseArray::using($list, $listName, $callable); |
@@ -543,7 +543,7 @@ discard block |
||
543 | 543 | /** |
544 | 544 | * is $item something that PHP will accept as a string? |
545 | 545 | * |
546 | - * @param mixed $item |
|
546 | + * @param string $item |
|
547 | 547 | * the variable to examine |
548 | 548 | * @return bool |
549 | 549 | * TRUE if PHP will happily use $item as a string |
@@ -652,7 +652,7 @@ discard block |
||
652 | 652 | /** |
653 | 653 | * what PHP type is $item? |
654 | 654 | * |
655 | - * @param mixed $item |
|
655 | + * @param string $item |
|
656 | 656 | * the data to examine |
657 | 657 | * @param int $flags |
658 | 658 | * options to change what we put in the return value |
@@ -669,7 +669,7 @@ discard block |
||
669 | 669 | * |
670 | 670 | * @param mixed $item |
671 | 671 | * the item to examine |
672 | - * @return array |
|
672 | + * @return string[] |
|
673 | 673 | * the list of type(s) that this item can be |
674 | 674 | */ |
675 | 675 | function get_strict_types($item) |
@@ -194,7 +194,7 @@ |
||
194 | 194 | * |
195 | 195 | * @param mixed $item |
196 | 196 | * the item to examine |
197 | - * @return array |
|
197 | + * @return string[] |
|
198 | 198 | * the basic type of the examined item |
199 | 199 | */ |
200 | 200 | private static function fromString($item) |
@@ -44,13 +44,13 @@ |
||
44 | 44 | use GanbaroDigital\MissingBits\TraceInspectors\GetCaller; |
45 | 45 | use GanbaroDigital\MissingBits\TraceInspectors\StackFrame; |
46 | 46 | |
47 | - /** |
|
48 | - * work out who has called a piece of code |
|
49 | - * |
|
50 | - * @param array $filterList |
|
51 | - * a list of namespaces and classes to skip over |
|
52 | - * @return StackFrame |
|
53 | - */ |
|
47 | + /** |
|
48 | + * work out who has called a piece of code |
|
49 | + * |
|
50 | + * @param array $filterList |
|
51 | + * a list of namespaces and classes to skip over |
|
52 | + * @return StackFrame |
|
53 | + */ |
|
54 | 54 | function get_caller(array $filterList = []) |
55 | 55 | { |
56 | 56 | // we supply the trace |
@@ -57,13 +57,37 @@ |
||
57 | 57 | */ |
58 | 58 | interface Throwable |
59 | 59 | { |
60 | + |
|
61 | + /** |
|
62 | + * @return string |
|
63 | + */ |
|
60 | 64 | public function getMessage(); |
61 | 65 | public function getCode(); |
66 | + |
|
67 | + /** |
|
68 | + * @return string |
|
69 | + */ |
|
62 | 70 | public function getFile(); |
71 | + |
|
72 | + /** |
|
73 | + * @return integer |
|
74 | + */ |
|
63 | 75 | public function getLine(); |
64 | 76 | public function getTrace(); |
77 | + |
|
78 | + /** |
|
79 | + * @return string |
|
80 | + */ |
|
65 | 81 | public function getTraceAsString(); |
82 | + |
|
83 | + /** |
|
84 | + * @return Exception |
|
85 | + */ |
|
66 | 86 | public function getPrevious(); |
87 | + |
|
88 | + /** |
|
89 | + * @return string |
|
90 | + */ |
|
67 | 91 | public function __toString(); |
68 | 92 | } |
69 | 93 | } |
@@ -69,9 +69,9 @@ |
||
69 | 69 | } |
70 | 70 | |
71 | 71 | if (!class_exists('Error')) { |
72 | - /** |
|
73 | - * taken from: http://php.net/manual/en/class.error.php |
|
74 | - */ |
|
72 | + /** |
|
73 | + * taken from: http://php.net/manual/en/class.error.php |
|
74 | + */ |
|
75 | 75 | class Error extends Exception implements Throwable |
76 | 76 | { |
77 | 77 | public function __toString() |