@@ -37,7 +37,7 @@ discard block |
||
37 | 37 | * Define an option and its value. |
38 | 38 | * |
39 | 39 | * @param string $key |
40 | - * @param mixed $value |
|
40 | + * @param string $value |
|
41 | 41 | * @return $this For method chaining |
42 | 42 | * @throws \InvalidArgumentException if key type is not a string or integer |
43 | 43 | */ |
@@ -73,7 +73,7 @@ discard block |
||
73 | 73 | /** |
74 | 74 | * Get the value of a single option or return false if it doesn't exist |
75 | 75 | * |
76 | - * @param string|integer $key |
|
76 | + * @param string $key |
|
77 | 77 | * @return string|integer|boolean The option value |
78 | 78 | */ |
79 | 79 | public function getOption($key) |
@@ -143,7 +143,7 @@ discard block |
||
143 | 143 | * data object. |
144 | 144 | * |
145 | 145 | * @param string $key The index to use |
146 | - * @param string|integer $value The value to set |
|
146 | + * @param string $value The value to set |
|
147 | 147 | * @return $this |
148 | 148 | * @throws \Exception |
149 | 149 | */ |
@@ -268,7 +268,7 @@ discard block |
||
268 | 268 | /** |
269 | 269 | * Return the information array relating to a specific column |
270 | 270 | * |
271 | - * @param string|integer $key |
|
271 | + * @param string $key |
|
272 | 272 | * @return array |
273 | 273 | * @throws \Exception |
274 | 274 | */ |
@@ -299,7 +299,7 @@ discard block |
||
299 | 299 | /** |
300 | 300 | * Return a specific piece of data from the current data point |
301 | 301 | * |
302 | - * @param string|integer $key |
|
302 | + * @param string $key |
|
303 | 303 | * @return mixed |
304 | 304 | */ |
305 | 305 | public function getPointValue($key) |
@@ -106,15 +106,15 @@ discard block |
||
106 | 106 | ); |
107 | 107 | } |
108 | 108 | |
109 | - /** |
|
110 | - * Increment the value for a key that makes up part of the currently focused |
|
111 | - * data object. |
|
112 | - * |
|
113 | - * @param string $key The index to use |
|
114 | - * @param int $value The value to increment by |
|
115 | - * @return $this |
|
116 | - * @throws \Exception if there is no data point, column or invalid type |
|
117 | - */ |
|
109 | + /** |
|
110 | + * Increment the value for a key that makes up part of the currently focused |
|
111 | + * data object. |
|
112 | + * |
|
113 | + * @param string $key The index to use |
|
114 | + * @param int $value The value to increment by |
|
115 | + * @return $this |
|
116 | + * @throws \Exception if there is no data point, column or invalid type |
|
117 | + */ |
|
118 | 118 | public function increment($key, $value = 1) |
119 | 119 | { |
120 | 120 | if (!$this->currentDataPoint) { |
@@ -138,15 +138,15 @@ discard block |
||
138 | 138 | return $this; |
139 | 139 | } |
140 | 140 | |
141 | - /** |
|
142 | - * Directly set the value for a key that makes up part of the currently focused |
|
143 | - * data object. |
|
144 | - * |
|
145 | - * @param string $key The index to use |
|
146 | - * @param string|integer $value The value to set |
|
147 | - * @return $this |
|
148 | - * @throws \Exception |
|
149 | - */ |
|
141 | + /** |
|
142 | + * Directly set the value for a key that makes up part of the currently focused |
|
143 | + * data object. |
|
144 | + * |
|
145 | + * @param string $key The index to use |
|
146 | + * @param string|integer $value The value to set |
|
147 | + * @return $this |
|
148 | + * @throws \Exception |
|
149 | + */ |
|
150 | 150 | public function set($key, $value) |
151 | 151 | { |
152 | 152 | if (!$this->currentDataPoint) { |
@@ -161,13 +161,13 @@ discard block |
||
161 | 161 | return $this; |
162 | 162 | } |
163 | 163 | |
164 | - /** |
|
165 | - * Set a focus for the current data object for which data can be manipulated. |
|
166 | - * If the key doesn't exist, it will be created using default column values. |
|
167 | - * |
|
168 | - * @param string $key The reference key to be used |
|
169 | - * @return $this |
|
170 | - */ |
|
164 | + /** |
|
165 | + * Set a focus for the current data object for which data can be manipulated. |
|
166 | + * If the key doesn't exist, it will be created using default column values. |
|
167 | + * |
|
168 | + * @param string $key The reference key to be used |
|
169 | + * @return $this |
|
170 | + */ |
|
171 | 171 | public function setPoint($key) |
172 | 172 | { |
173 | 173 | if (!isset($this->currentDataSet[$key])) { |
@@ -178,14 +178,14 @@ discard block |
||
178 | 178 | return $this; |
179 | 179 | } |
180 | 180 | |
181 | - /** |
|
182 | - * Add a data point which will be shown on the report. This function should be |
|
183 | - * used prior to any kind of data manipulation as it will not setup a data |
|
184 | - * structure for manipulation. |
|
185 | - * |
|
186 | - * @param string $key The index to use |
|
187 | - * @return $this |
|
188 | - */ |
|
181 | + /** |
|
182 | + * Add a data point which will be shown on the report. This function should be |
|
183 | + * used prior to any kind of data manipulation as it will not setup a data |
|
184 | + * structure for manipulation. |
|
185 | + * |
|
186 | + * @param string $key The index to use |
|
187 | + * @return $this |
|
188 | + */ |
|
189 | 189 | public function addPoint($key) |
190 | 190 | { |
191 | 191 | if (!in_array($key, $this->dataPoints)) { |
@@ -196,20 +196,20 @@ discard block |
||
196 | 196 | return $this; |
197 | 197 | } |
198 | 198 | |
199 | - /** |
|
200 | - * Define a type of data that will be presented on the report or metadata that |
|
201 | - * will be used for calculations. In the latter case, within the options array |
|
202 | - * set "visible" to false. |
|
203 | - * At a minimum, the key needs to be set. In this case, the type will be string |
|
204 | - * and the key converted in to a title |
|
205 | - * . |
|
206 | - * |
|
207 | - * @param string $key A reference key for the piece of data |
|
208 | - * @param string|integer $defaultValue The default also defines type of column |
|
209 | - * @param array $options Additional parameters for the column to use |
|
210 | - * |
|
211 | - * @return $this |
|
212 | - */ |
|
199 | + /** |
|
200 | + * Define a type of data that will be presented on the report or metadata that |
|
201 | + * will be used for calculations. In the latter case, within the options array |
|
202 | + * set "visible" to false. |
|
203 | + * At a minimum, the key needs to be set. In this case, the type will be string |
|
204 | + * and the key converted in to a title |
|
205 | + * . |
|
206 | + * |
|
207 | + * @param string $key A reference key for the piece of data |
|
208 | + * @param string|integer $defaultValue The default also defines type of column |
|
209 | + * @param array $options Additional parameters for the column to use |
|
210 | + * |
|
211 | + * @return $this |
|
212 | + */ |
|
213 | 213 | public function column( |
214 | 214 | $key, |
215 | 215 | $defaultValue = '', |
@@ -242,15 +242,15 @@ discard block |
||
242 | 242 | } |
243 | 243 | |
244 | 244 | /** |
245 | - * Manually set the data which will be used for the current set. when |
|
246 | - * using this function, it will expect an associative array of arrays where |
|
247 | - * each entry has a further array of values which have a key matching that of |
|
248 | - * the meta data. |
|
249 | - * TODO - This is quite messy, rewrite more efficiently. |
|
250 | - * |
|
251 | - * @param array $inputData A set of data which conforms to the column specification |
|
252 | - * @return $this |
|
253 | - */ |
|
245 | + * Manually set the data which will be used for the current set. when |
|
246 | + * using this function, it will expect an associative array of arrays where |
|
247 | + * each entry has a further array of values which have a key matching that of |
|
248 | + * the meta data. |
|
249 | + * TODO - This is quite messy, rewrite more efficiently. |
|
250 | + * |
|
251 | + * @param array $inputData A set of data which conforms to the column specification |
|
252 | + * @return $this |
|
253 | + */ |
|
254 | 254 | public function setData($inputData) |
255 | 255 | { |
256 | 256 | // Combine raw data with the meta data |