diff --git a/src/main/java/org/apache/commons/csv/CSVParser.java b/src/main/java/org/apache/commons/csv/CSVParser.java index 11d1bba7..fd4c3a90 100644 --- a/src/main/java/org/apache/commons/csv/CSVParser.java +++ b/src/main/java/org/apache/commons/csv/CSVParser.java @@ -740,18 +740,10 @@ public final class CSVParser implements Iterable, Closeable { * {@link NoSuchElementException}. *

*

- * For example, the iterator from code such as - *

-     * Iterator{@code} items() throws IOException {
-     *    try (CSVParser parser = CSVParser.parse( ... )) {
-     *       return parser.iterator();
-     *    }
-     * }
-     * 
- * will never yield any records because the parser is closed by the - * try-with-resources block. - * An alternative is to extract all records as a list with + * If it is necessary to construct an iterator which is usable after the + * parser is closed, one option is to extract all records as a list with * {@link getRecords()}, and return an iterator to that list. + *

*/ @Override public Iterator iterator() { @@ -817,6 +809,7 @@ public final class CSVParser implements Iterable, Closeable { *

* If the parser is closed, the stream will not produce any more values. * See the comments in {@link iterator()}. + *

* @return a sequential {@code Stream} with this collection as its source. * @since 1.9.0 */