@@ -22,8 +22,6 @@ |
||
22 | 22 | use CSVelte\Contract\Writable; |
23 | 23 | use CSVelte\Contract\Seekable; |
24 | 24 | |
25 | -use CSVelte\Exception\NotYetImplementedException; |
|
26 | - |
|
27 | 25 | /** |
28 | 26 | * CSVelte File. |
29 | 27 | * |
@@ -145,6 +145,7 @@ discard block |
||
145 | 145 | * ``fopen`` function |
146 | 146 | * @param array Stream context options array as passed to native php |
147 | 147 | * ``stream_context_create`` function |
148 | + * @param string $mode |
|
148 | 149 | * @see http://php.net/manual/en/function.fopen.php |
149 | 150 | * @see http://php.net/manual/en/function.stream-context-create.php |
150 | 151 | */ |
@@ -174,7 +175,7 @@ discard block |
||
174 | 175 | * ``fopen`` function) |
175 | 176 | * @param array $context Stream context options array as passed to native |
176 | 177 | * php ``stream_context_create`` function |
177 | - * @return stream resource object |
|
178 | + * @return resource resource object |
|
178 | 179 | * @throws CSVelte\Exception\IOException on invalid stream uri/resource |
179 | 180 | * @throws \InvalidArgumentException if context param is not an array |
180 | 181 | * @see http://php.net/manual/en/function.fopen.php |
@@ -328,7 +329,7 @@ discard block |
||
328 | 329 | * Reads $length bytes (number of characters) from the stream |
329 | 330 | * |
330 | 331 | * @param int $length Number of bytes to read from stream |
331 | - * @return string|boolean The data read from stream or false if at end of |
|
332 | + * @return false|string The data read from stream or false if at end of |
|
332 | 333 | * file or some other problem. |
333 | 334 | * @throws CSVelte\Exception\IOException |
334 | 335 | */ |
@@ -16,14 +16,11 @@ |
||
16 | 16 | use CSVelte\Traits\IsReadable; |
17 | 17 | use CSVelte\Traits\IsWritable; |
18 | 18 | use CSVelte\Traits\IsSeekable; |
19 | - |
|
20 | 19 | use CSVelte\Contract\Readable; |
21 | 20 | use CSVelte\Contract\Writable; |
22 | 21 | use CSVelte\Contract\Seekable; |
23 | 22 | |
24 | 23 | use \InvalidArgumentException; |
25 | -use CSVelte\Exception\NotYetImplementedException; |
|
26 | -use CSVelte\Exception\EndOfFileException; |
|
27 | 24 | use CSVelte\Exception\IOException; |
28 | 25 | |
29 | 26 | /** |
@@ -90,7 +90,7 @@ discard block |
||
90 | 90 | * likely buffer the output so that this may be called after writeRows() |
91 | 91 | * |
92 | 92 | * @param \Iterator|array A list of header values |
93 | - * @return boolean |
|
93 | + * @return boolean|null |
|
94 | 94 | * @throws \CSVelte\Exception\WriterException |
95 | 95 | */ |
96 | 96 | public function setHeaderRow($headers) |
@@ -161,7 +161,7 @@ discard block |
||
161 | 161 | * This means taking an array of data, and converting it to a Row object |
162 | 162 | * |
163 | 163 | * @param \Iterator|array of data items |
164 | - * @return CSVelte\Table\AbstractRow |
|
164 | + * @return Row |
|
165 | 165 | * @access protected |
166 | 166 | */ |
167 | 167 | protected function prepareRow(Iterator $row) |
@@ -189,6 +189,9 @@ discard block |
||
189 | 189 | return $this->quoteString($data); |
190 | 190 | } |
191 | 191 | |
192 | + /** |
|
193 | + * @param string $str |
|
194 | + */ |
|
192 | 195 | protected function quoteString($str) |
193 | 196 | { |
194 | 197 | $flvr = $this->getFlavor(); |
@@ -126,7 +126,7 @@ discard block |
||
126 | 126 | * readable (can be read). This will make sure that whatever is passed to |
127 | 127 | * the reader meets these expectations and set $this->source. |
128 | 128 | * |
129 | - * @param \CSVelte\Contract\Readable|object|string $input See description |
|
129 | + * @param Readable $input See description |
|
130 | 130 | * @return $this |
131 | 131 | */ |
132 | 132 | protected function setSource($input) |
@@ -325,6 +325,9 @@ discard block |
||
325 | 325 | * @todo This actually shouldn't even be necessary. Characters should be read |
326 | 326 | * in one at a time and a quote that follows another should just be ignored |
327 | 327 | * deeming this unnecessary. |
328 | + * @param string $str |
|
329 | + * @param string $esc |
|
330 | + * @param string $quo |
|
328 | 331 | */ |
329 | 332 | protected function unEscape($str, $esc, $quo) |
330 | 333 | { |
@@ -335,6 +338,7 @@ discard block |
||
335 | 338 | * Parse a line of CSV data into an array of columns |
336 | 339 | * |
337 | 340 | * @param string A line of CSV data to parse |
341 | + * @param string $line |
|
338 | 342 | * @return array An array of columns |
339 | 343 | * @access protected |
340 | 344 | * @internal |
@@ -165,6 +165,7 @@ discard block |
||
165 | 165 | * replaceQuotedSpecialChars method which (at least to me) makes more sense. |
166 | 166 | * |
167 | 167 | * @param string The string to replace quoted strings within |
168 | + * @param string $data |
|
168 | 169 | * @return string The input string with quoted strings removed |
169 | 170 | * @access protected |
170 | 171 | * @todo Replace code that uses this method with the replaceQuotedSpecialChars |
@@ -414,7 +415,7 @@ discard block |
||
414 | 415 | * Determine whether a particular string of data has quotes around it. |
415 | 416 | * |
416 | 417 | * @param string The data to check |
417 | - * @return boolean Whether the data is quoted or not |
|
418 | + * @return integer Whether the data is quoted or not |
|
418 | 419 | * @access protected |
419 | 420 | */ |
420 | 421 | protected function isQuoted($data) |
@@ -464,6 +465,8 @@ discard block |
||
464 | 465 | * |
465 | 466 | * @param string The string to do the replacements on |
466 | 467 | * @param string The delimiter character to replace |
468 | + * @param string $data |
|
469 | + * @param string $delim |
|
467 | 470 | * @return string The data with replacements performed |
468 | 471 | * @access protected |
469 | 472 | * @todo I could probably pass in (maybe optionally) the newline character I |
@@ -490,6 +493,7 @@ discard block |
||
490 | 493 | * to be practical. |
491 | 494 | * |
492 | 495 | * @param string The string of data to check the type of |
496 | + * @param string $data |
|
493 | 497 | * @return string One of the TYPE_ string constants above |
494 | 498 | * @access protected |
495 | 499 | * @uses \Carbon\Carbon date/time ilbrary/class |
@@ -546,6 +550,7 @@ discard block |
||
546 | 550 | * @param string $delim The CSV data's delimiting char (can be a variety of chars but) |
547 | 551 | * typically $eol is either a comma or a tab, sometimes a pipe) |
548 | 552 | * @param string The CSV data's end-of-line char(s) (\n \r or \r\n) |
553 | + * @param string $eol |
|
549 | 554 | * @return boolean True if the data (most likely) contains a header row |
550 | 555 | * @access public |
551 | 556 | * @todo This method needs a total refactor. It's not necessary to loop twice |