Modified:
websites/production/commons/content/proper/commons-csv/apidocs/src-html/org/apache/commons/csv/CSVParser.html
==============================================================================
---
websites/production/commons/content/proper/commons-csv/apidocs/src-html/org/apache/commons/csv/CSVParser.html
(original)
+++
websites/production/commons/content/proper/commons-csv/apidocs/src-html/org/apache/commons/csv/CSVParser.html
Wed Sep 25 02:11:29 2024
@@ -1,5 +1,5 @@
<!DOCTYPE HTML>
-<html lang="en">
+<html lang>
<head>
<!-- Generated by javadoc (17) -->
<title>Source code</title>
@@ -85,7 +85,7 @@
<span class="source-line-no">072</span><span id="line-72"> * For those who
like fluent APIs, parsers can be created using {@link
CSVFormat#parse(java.io.Reader)} as a shortcut:</span>
<span class="source-line-no">073</span><span id="line-73"> * </p></span>
<span class="source-line-no">074</span><span id="line-74"> * <pre></span>
-<span class="source-line-no">075</span><span id="line-75"> * for(CSVRecord
record : CSVFormat.EXCEL.parse(in)) {</span>
+<span class="source-line-no">075</span><span id="line-75"> * for (CSVRecord
record : CSVFormat.EXCEL.parse(in)) {</span>
<span class="source-line-no">076</span><span id="line-76"> * ...</span>
<span class="source-line-no">077</span><span id="line-77"> * }</span>
<span class="source-line-no">078</span><span id="line-78"> *
</pre></span>
@@ -95,12 +95,12 @@
<span class="source-line-no">082</span><span id="line-82"> * To parse a CSV
input from a file, you write:</span>
<span class="source-line-no">083</span><span id="line-83"> * </p></span>
<span class="source-line-no">084</span><span id="line-84"> *</span>
-<span class="source-line-no">085</span><span id="line-85"> * <pre></span>
-<span class="source-line-no">086</span><span id="line-86"> * File csvData =
new File(&quot;/path/to/csv&quot;);</span>
+<span class="source-line-no">085</span><span id="line-85"> *
<pre>{@code</span>
+<span class="source-line-no">086</span><span id="line-86"> * File csvData =
new File("/path/to/csv");</span>
<span class="source-line-no">087</span><span id="line-87"> * CSVParser parser
= CSVParser.parse(csvData, CSVFormat.RFC4180);</span>
<span class="source-line-no">088</span><span id="line-88"> * for (CSVRecord
csvRecord : parser) {</span>
<span class="source-line-no">089</span><span id="line-89"> * ...</span>
-<span class="source-line-no">090</span><span id="line-90"> * }</span>
+<span class="source-line-no">090</span><span id="line-90"> * }}</span>
<span class="source-line-no">091</span><span id="line-91"> *
</pre></span>
<span class="source-line-no">092</span><span id="line-92"> *</span>
<span class="source-line-no">093</span><span id="line-93"> * <p></span>
@@ -129,11 +129,11 @@
<span class="source-line-no">116</span><span id="line-116"> * If parsing
record-wise is not desired, the contents of the input can be read completely
into memory.</span>
<span class="source-line-no">117</span><span id="line-117"> * </p></span>
<span class="source-line-no">118</span><span id="line-118"> *</span>
-<span class="source-line-no">119</span><span id="line-119"> *
<pre></span>
-<span class="source-line-no">120</span><span id="line-120"> * Reader in = new
StringReader(&quot;a;b\nc;d&quot;);</span>
+<span class="source-line-no">119</span><span id="line-119"> *
<pre>{@code</span>
+<span class="source-line-no">120</span><span id="line-120"> * Reader in = new
StringReader("a;b\nc;d");</span>
<span class="source-line-no">121</span><span id="line-121"> * CSVParser parser
= new CSVParser(in, CSVFormat.EXCEL);</span>
-<span class="source-line-no">122</span><span id="line-122"> *
List&lt;CSVRecord&gt; list = parser.getRecords();</span>
-<span class="source-line-no">123</span><span id="line-123"> *
</pre></span>
+<span class="source-line-no">122</span><span id="line-122"> *
List<CSVRecord> list = parser.getRecords();</span>
+<span class="source-line-no">123</span><span id="line-123"> *
}</pre></span>
<span class="source-line-no">124</span><span id="line-124"> *</span>
<span class="source-line-no">125</span><span id="line-125"> * <p></span>
<span class="source-line-no">126</span><span id="line-126"> * There are two
constraints that have to be kept in mind:</span>
@@ -158,671 +158,685 @@
<span class="source-line-no">145</span><span id="line-145"> final class
CSVRecordIterator implements Iterator<CSVRecord> {</span>
<span class="source-line-no">146</span><span id="line-146"> private
CSVRecord current;</span>
<span class="source-line-no">147</span><span id="line-147"></span>
-<span class="source-line-no">148</span><span id="line-148"> private
CSVRecord getNextRecord() {</span>
-<span class="source-line-no">149</span><span id="line-149"> return
Uncheck.get(CSVParser.this::nextRecord);</span>
-<span class="source-line-no">150</span><span id="line-150"> }</span>
-<span class="source-line-no">151</span><span id="line-151"></span>
-<span class="source-line-no">152</span><span id="line-152">
@Override</span>
-<span class="source-line-no">153</span><span id="line-153"> public
boolean hasNext() {</span>
-<span class="source-line-no">154</span><span id="line-154"> if
(CSVParser.this.isClosed()) {</span>
-<span class="source-line-no">155</span><span id="line-155">
return false;</span>
-<span class="source-line-no">156</span><span id="line-156"> }</span>
-<span class="source-line-no">157</span><span id="line-157"> if
(current == null) {</span>
-<span class="source-line-no">158</span><span id="line-158">
current = getNextRecord();</span>
-<span class="source-line-no">159</span><span id="line-159"> }</span>
-<span class="source-line-no">160</span><span id="line-160"></span>
-<span class="source-line-no">161</span><span id="line-161"> return
current != null;</span>
-<span class="source-line-no">162</span><span id="line-162"> }</span>
-<span class="source-line-no">163</span><span id="line-163"></span>
-<span class="source-line-no">164</span><span id="line-164">
@Override</span>
-<span class="source-line-no">165</span><span id="line-165"> public
CSVRecord next() {</span>
-<span class="source-line-no">166</span><span id="line-166"> if
(CSVParser.this.isClosed()) {</span>
-<span class="source-line-no">167</span><span id="line-167">
throw new NoSuchElementException("CSVParser has been closed");</span>
-<span class="source-line-no">168</span><span id="line-168"> }</span>
-<span class="source-line-no">169</span><span id="line-169">
CSVRecord next = current;</span>
-<span class="source-line-no">170</span><span id="line-170"> current
= null;</span>
-<span class="source-line-no">171</span><span id="line-171"></span>
-<span class="source-line-no">172</span><span id="line-172"> if
(next == null) {</span>
-<span class="source-line-no">173</span><span id="line-173"> //
hasNext() wasn't called before</span>
-<span class="source-line-no">174</span><span id="line-174">
next = getNextRecord();</span>
-<span class="source-line-no">175</span><span id="line-175"> if
(next == null) {</span>
-<span class="source-line-no">176</span><span id="line-176">
throw new NoSuchElementException("No more CSV records available");</span>
-<span class="source-line-no">177</span><span id="line-177">
}</span>
-<span class="source-line-no">178</span><span id="line-178"> }</span>
-<span class="source-line-no">179</span><span id="line-179"></span>
-<span class="source-line-no">180</span><span id="line-180"> return
next;</span>
-<span class="source-line-no">181</span><span id="line-181"> }</span>
-<span class="source-line-no">182</span><span id="line-182"></span>
-<span class="source-line-no">183</span><span id="line-183">
@Override</span>
-<span class="source-line-no">184</span><span id="line-184"> public void
remove() {</span>
-<span class="source-line-no">185</span><span id="line-185"> throw
new UnsupportedOperationException();</span>
+<span class="source-line-no">148</span><span id="line-148"> /**</span>
+<span class="source-line-no">149</span><span id="line-149"> * Gets the
next record.</span>
+<span class="source-line-no">150</span><span id="line-150"> *</span>
+<span class="source-line-no">151</span><span id="line-151"> * @return
the next record.</span>
+<span class="source-line-no">152</span><span id="line-152"> */</span>
+<span class="source-line-no">153</span><span id="line-153"> private
CSVRecord getNextRecord() {</span>
+<span class="source-line-no">154</span><span id="line-154"> return
Uncheck.get(CSVParser.this::nextRecord);</span>
+<span class="source-line-no">155</span><span id="line-155"> }</span>
+<span class="source-line-no">156</span><span id="line-156"></span>
+<span class="source-line-no">157</span><span id="line-157">
@Override</span>
+<span class="source-line-no">158</span><span id="line-158"> public
boolean hasNext() {</span>
+<span class="source-line-no">159</span><span id="line-159"> if
(isClosed()) {</span>
+<span class="source-line-no">160</span><span id="line-160">
return false;</span>
+<span class="source-line-no">161</span><span id="line-161"> }</span>
+<span class="source-line-no">162</span><span id="line-162"> if
(current == null) {</span>
+<span class="source-line-no">163</span><span id="line-163">
current = getNextRecord();</span>
+<span class="source-line-no">164</span><span id="line-164"> }</span>
+<span class="source-line-no">165</span><span id="line-165"></span>
+<span class="source-line-no">166</span><span id="line-166"> return
current != null;</span>
+<span class="source-line-no">167</span><span id="line-167"> }</span>
+<span class="source-line-no">168</span><span id="line-168"></span>
+<span class="source-line-no">169</span><span id="line-169">
@Override</span>
+<span class="source-line-no">170</span><span id="line-170"> public
CSVRecord next() {</span>
+<span class="source-line-no">171</span><span id="line-171"> if
(isClosed()) {</span>
+<span class="source-line-no">172</span><span id="line-172">
throw new NoSuchElementException("CSVParser has been closed");</span>
+<span class="source-line-no">173</span><span id="line-173"> }</span>
+<span class="source-line-no">174</span><span id="line-174">
CSVRecord next = current;</span>
+<span class="source-line-no">175</span><span id="line-175"> current
= null;</span>
+<span class="source-line-no">176</span><span id="line-176"></span>
+<span class="source-line-no">177</span><span id="line-177"> if
(next == null) {</span>
+<span class="source-line-no">178</span><span id="line-178"> //
hasNext() wasn't called before</span>
+<span class="source-line-no">179</span><span id="line-179">
next = getNextRecord();</span>
+<span class="source-line-no">180</span><span id="line-180"> if
(next == null) {</span>
+<span class="source-line-no">181</span><span id="line-181">
throw new NoSuchElementException("No more CSV records available");</span>
+<span class="source-line-no">182</span><span id="line-182">
}</span>
+<span class="source-line-no">183</span><span id="line-183"> }</span>
+<span class="source-line-no">184</span><span id="line-184"></span>
+<span class="source-line-no">185</span><span id="line-185"> return
next;</span>
<span class="source-line-no">186</span><span id="line-186"> }</span>
-<span class="source-line-no">187</span><span id="line-187"> }</span>
-<span class="source-line-no">188</span><span id="line-188"></span>
-<span class="source-line-no">189</span><span id="line-189"> /**</span>
-<span class="source-line-no">190</span><span id="line-190"> * Header
information based on name and position.</span>
-<span class="source-line-no">191</span><span id="line-191"> */</span>
-<span class="source-line-no">192</span><span id="line-192"> private static
final class Headers {</span>
+<span class="source-line-no">187</span><span id="line-187"></span>
+<span class="source-line-no">188</span><span id="line-188">
@Override</span>
+<span class="source-line-no">189</span><span id="line-189"> public void
remove() {</span>
+<span class="source-line-no">190</span><span id="line-190"> throw
new UnsupportedOperationException();</span>
+<span class="source-line-no">191</span><span id="line-191"> }</span>
+<span class="source-line-no">192</span><span id="line-192"> }</span>
<span class="source-line-no">193</span><span id="line-193"></span>
-<span class="source-line-no">194</span><span id="line-194"> /**</span>
-<span class="source-line-no">195</span><span id="line-195"> * Header
column positions (0-based)</span>
-<span class="source-line-no">196</span><span id="line-196"> */</span>
-<span class="source-line-no">197</span><span id="line-197"> final
Map<String, Integer> headerMap;</span>
+<span class="source-line-no">194</span><span id="line-194"> /**</span>
+<span class="source-line-no">195</span><span id="line-195"> * Header
information based on name and position.</span>
+<span class="source-line-no">196</span><span id="line-196"> */</span>
+<span class="source-line-no">197</span><span id="line-197"> private static
final class Headers {</span>
<span class="source-line-no">198</span><span id="line-198"></span>
<span class="source-line-no">199</span><span id="line-199"> /**</span>
-<span class="source-line-no">200</span><span id="line-200"> * Header
names in column order</span>
+<span class="source-line-no">200</span><span id="line-200"> * Header
column positions (0-based)</span>
<span class="source-line-no">201</span><span id="line-201"> */</span>
-<span class="source-line-no">202</span><span id="line-202"> final
List<String> headerNames;</span>
+<span class="source-line-no">202</span><span id="line-202"> final
Map<String, Integer> headerMap;</span>
<span class="source-line-no">203</span><span id="line-203"></span>
-<span class="source-line-no">204</span><span id="line-204">
Headers(final Map<String, Integer> headerMap, final List<String>
headerNames) {</span>
-<span class="source-line-no">205</span><span id="line-205">
this.headerMap = headerMap;</span>
-<span class="source-line-no">206</span><span id="line-206">
this.headerNames = headerNames;</span>
-<span class="source-line-no">207</span><span id="line-207"> }</span>
-<span class="source-line-no">208</span><span id="line-208"> }</span>
-<span class="source-line-no">209</span><span id="line-209"></span>
-<span class="source-line-no">210</span><span id="line-210"> /**</span>
-<span class="source-line-no">211</span><span id="line-211"> * Creates a
parser for the given {@link File}.</span>
-<span class="source-line-no">212</span><span id="line-212"> *</span>
-<span class="source-line-no">213</span><span id="line-213"> * @param
file</span>
-<span class="source-line-no">214</span><span id="line-214"> * a
CSV file. Must not be null.</span>
-<span class="source-line-no">215</span><span id="line-215"> * @param
charset</span>
-<span class="source-line-no">216</span><span id="line-216"> *
The Charset to decode the given file.</span>
-<span class="source-line-no">217</span><span id="line-217"> * @param
format</span>
-<span class="source-line-no">218</span><span id="line-218"> *
the CSVFormat used for CSV parsing. Must not be null.</span>
-<span class="source-line-no">219</span><span id="line-219"> * @return a
new parser</span>
-<span class="source-line-no">220</span><span id="line-220"> * @throws
IllegalArgumentException</span>
-<span class="source-line-no">221</span><span id="line-221"> *
If the parameters of the format are inconsistent or if either file or format
are null.</span>
-<span class="source-line-no">222</span><span id="line-222"> * @throws
IOException</span>
-<span class="source-line-no">223</span><span id="line-223"> *
If an I/O error occurs</span>
-<span class="source-line-no">224</span><span id="line-224"> */</span>
-<span class="source-line-no">225</span><span id="line-225"> public static
CSVParser parse(final File file, final Charset charset, final CSVFormat format)
throws IOException {</span>
-<span class="source-line-no">226</span><span id="line-226">
Objects.requireNonNull(file, "file");</span>
-<span class="source-line-no">227</span><span id="line-227"> return
parse(file.toPath(), charset, format);</span>
-<span class="source-line-no">228</span><span id="line-228"> }</span>
-<span class="source-line-no">229</span><span id="line-229"></span>
-<span class="source-line-no">230</span><span id="line-230"> /**</span>
-<span class="source-line-no">231</span><span id="line-231"> * Creates a
CSV parser using the given {@link CSVFormat}.</span>
-<span class="source-line-no">232</span><span id="line-232"> *</span>
-<span class="source-line-no">233</span><span id="line-233"> *
<p></span>
-<span class="source-line-no">234</span><span id="line-234"> * If you do
not read all records from the given {@code reader}, you should call {@link
#close()} on the parser,</span>
-<span class="source-line-no">235</span><span id="line-235"> * unless you
close the {@code reader}.</span>
-<span class="source-line-no">236</span><span id="line-236"> *
</p></span>
-<span class="source-line-no">237</span><span id="line-237"> *</span>
-<span class="source-line-no">238</span><span id="line-238"> * @param
inputStream</span>
-<span class="source-line-no">239</span><span id="line-239"> *
an InputStream containing CSV-formatted input. Must not be null.</span>
-<span class="source-line-no">240</span><span id="line-240"> * @param
charset</span>
-<span class="source-line-no">241</span><span id="line-241"> *
The Charset to decode the given file.</span>
-<span class="source-line-no">242</span><span id="line-242"> * @param
format</span>
-<span class="source-line-no">243</span><span id="line-243"> *
the CSVFormat used for CSV parsing. Must not be null.</span>
-<span class="source-line-no">244</span><span id="line-244"> * @return a
new CSVParser configured with the given reader and format.</span>
-<span class="source-line-no">245</span><span id="line-245"> * @throws
IllegalArgumentException</span>
-<span class="source-line-no">246</span><span id="line-246"> *
If the parameters of the format are inconsistent or if either reader or format
are null.</span>
-<span class="source-line-no">247</span><span id="line-247"> * @throws
IOException</span>
-<span class="source-line-no">248</span><span id="line-248"> *
If there is a problem reading the header or skipping the first record</span>
-<span class="source-line-no">249</span><span id="line-249"> * @since
1.5</span>
-<span class="source-line-no">250</span><span id="line-250"> */</span>
-<span class="source-line-no">251</span><span id="line-251">
@SuppressWarnings("resource")</span>
-<span class="source-line-no">252</span><span id="line-252"> public static
CSVParser parse(final InputStream inputStream, final Charset charset, final
CSVFormat format)</span>
-<span class="source-line-no">253</span><span id="line-253"> throws
IOException {</span>
-<span class="source-line-no">254</span><span id="line-254">
Objects.requireNonNull(inputStream, "inputStream");</span>
-<span class="source-line-no">255</span><span id="line-255">
Objects.requireNonNull(format, "format");</span>
-<span class="source-line-no">256</span><span id="line-256"> return
parse(new InputStreamReader(inputStream, charset), format);</span>
-<span class="source-line-no">257</span><span id="line-257"> }</span>
-<span class="source-line-no">258</span><span id="line-258"></span>
-<span class="source-line-no">259</span><span id="line-259"> /**</span>
-<span class="source-line-no">260</span><span id="line-260"> * Creates and
returns a parser for the given {@link Path}, which the caller MUST close.</span>
-<span class="source-line-no">261</span><span id="line-261"> *</span>
-<span class="source-line-no">262</span><span id="line-262"> * @param
path</span>
-<span class="source-line-no">263</span><span id="line-263"> * a
CSV file. Must not be null.</span>
-<span class="source-line-no">264</span><span id="line-264"> * @param
charset</span>
-<span class="source-line-no">265</span><span id="line-265"> *
The Charset to decode the given file.</span>
-<span class="source-line-no">266</span><span id="line-266"> * @param
format</span>
-<span class="source-line-no">267</span><span id="line-267"> *
the CSVFormat used for CSV parsing. Must not be null.</span>
-<span class="source-line-no">268</span><span id="line-268"> * @return a
new parser</span>
-<span class="source-line-no">269</span><span id="line-269"> * @throws
IllegalArgumentException</span>
-<span class="source-line-no">270</span><span id="line-270"> *
If the parameters of the format are inconsistent or if either file or format
are null.</span>
-<span class="source-line-no">271</span><span id="line-271"> * @throws
IOException</span>
-<span class="source-line-no">272</span><span id="line-272"> *
If an I/O error occurs</span>
-<span class="source-line-no">273</span><span id="line-273"> * @since
1.5</span>
-<span class="source-line-no">274</span><span id="line-274"> */</span>
-<span class="source-line-no">275</span><span id="line-275">
@SuppressWarnings("resource")</span>
-<span class="source-line-no">276</span><span id="line-276"> public static
CSVParser parse(final Path path, final Charset charset, final CSVFormat format)
throws IOException {</span>
-<span class="source-line-no">277</span><span id="line-277">
Objects.requireNonNull(path, "path");</span>
-<span class="source-line-no">278</span><span id="line-278">
Objects.requireNonNull(format, "format");</span>
-<span class="source-line-no">279</span><span id="line-279"> return
parse(Files.newInputStream(path), charset, format);</span>
-<span class="source-line-no">280</span><span id="line-280"> }</span>
-<span class="source-line-no">281</span><span id="line-281"></span>
-<span class="source-line-no">282</span><span id="line-282"> /**</span>
-<span class="source-line-no">283</span><span id="line-283"> * Creates a
CSV parser using the given {@link CSVFormat}</span>
-<span class="source-line-no">284</span><span id="line-284"> *</span>
-<span class="source-line-no">285</span><span id="line-285"> *
<p></span>
-<span class="source-line-no">286</span><span id="line-286"> * If you do
not read all records from the given {@code reader}, you should call {@link
#close()} on the parser,</span>
-<span class="source-line-no">287</span><span id="line-287"> * unless you
close the {@code reader}.</span>
-<span class="source-line-no">288</span><span id="line-288"> *
</p></span>
-<span class="source-line-no">289</span><span id="line-289"> *</span>
-<span class="source-line-no">290</span><span id="line-290"> * @param
reader</span>
-<span class="source-line-no">291</span><span id="line-291"> * a
Reader containing CSV-formatted input. Must not be null.</span>
-<span class="source-line-no">292</span><span id="line-292"> * @param
format</span>
-<span class="source-line-no">293</span><span id="line-293"> *
the CSVFormat used for CSV parsing. Must not be null.</span>
-<span class="source-line-no">294</span><span id="line-294"> * @return a
new CSVParser configured with the given reader and format.</span>
-<span class="source-line-no">295</span><span id="line-295"> * @throws
IllegalArgumentException</span>
-<span class="source-line-no">296</span><span id="line-296"> *
If the parameters of the format are inconsistent or if either reader or format
are null.</span>
-<span class="source-line-no">297</span><span id="line-297"> * @throws
IOException</span>
-<span class="source-line-no">298</span><span id="line-298"> *
If there is a problem reading the header or skipping the first record</span>
-<span class="source-line-no">299</span><span id="line-299"> * @since
1.5</span>
-<span class="source-line-no">300</span><span id="line-300"> */</span>
-<span class="source-line-no">301</span><span id="line-301"> public static
CSVParser parse(final Reader reader, final CSVFormat format) throws IOException
{</span>
-<span class="source-line-no">302</span><span id="line-302"> return new
CSVParser(reader, format);</span>
-<span class="source-line-no">303</span><span id="line-303"> }</span>
-<span class="source-line-no">304</span><span id="line-304"></span>
-<span class="source-line-no">305</span><span id="line-305"> /**</span>
-<span class="source-line-no">306</span><span id="line-306"> * Creates a
parser for the given {@link String}.</span>
-<span class="source-line-no">307</span><span id="line-307"> *</span>
-<span class="source-line-no">308</span><span id="line-308"> * @param
string</span>
-<span class="source-line-no">309</span><span id="line-309"> * a
CSV string. Must not be null.</span>
-<span class="source-line-no">310</span><span id="line-310"> * @param
format</span>
-<span class="source-line-no">311</span><span id="line-311"> *
the CSVFormat used for CSV parsing. Must not be null.</span>
-<span class="source-line-no">312</span><span id="line-312"> * @return a
new parser</span>
-<span class="source-line-no">313</span><span id="line-313"> * @throws
IllegalArgumentException</span>
-<span class="source-line-no">314</span><span id="line-314"> *
If the parameters of the format are inconsistent or if either string or format
are null.</span>
-<span class="source-line-no">315</span><span id="line-315"> * @throws
IOException</span>
-<span class="source-line-no">316</span><span id="line-316"> *
If an I/O error occurs</span>
-<span class="source-line-no">317</span><span id="line-317"> */</span>
-<span class="source-line-no">318</span><span id="line-318"> public static
CSVParser parse(final String string, final CSVFormat format) throws IOException
{</span>
-<span class="source-line-no">319</span><span id="line-319">
Objects.requireNonNull(string, "string");</span>
-<span class="source-line-no">320</span><span id="line-320">
Objects.requireNonNull(format, "format");</span>
-<span class="source-line-no">321</span><span id="line-321"></span>
-<span class="source-line-no">322</span><span id="line-322"> return new
CSVParser(new StringReader(string), format);</span>
-<span class="source-line-no">323</span><span id="line-323"> }</span>
-<span class="source-line-no">324</span><span id="line-324"></span>
-<span class="source-line-no">325</span><span id="line-325"> /**</span>
-<span class="source-line-no">326</span><span id="line-326"> * Creates and
returns a parser for the given URL, which the caller MUST close.</span>
-<span class="source-line-no">327</span><span id="line-327"> *</span>
-<span class="source-line-no">328</span><span id="line-328"> *
<p></span>
-<span class="source-line-no">329</span><span id="line-329"> * If you do
not read all records from the given {@code url}, you should call {@link
#close()} on the parser, unless</span>
-<span class="source-line-no">330</span><span id="line-330"> * you close
the {@code url}.</span>
-<span class="source-line-no">331</span><span id="line-331"> *
</p></span>
-<span class="source-line-no">332</span><span id="line-332"> *</span>
-<span class="source-line-no">333</span><span id="line-333"> * @param
url</span>
-<span class="source-line-no">334</span><span id="line-334"> * a
URL. Must not be null.</span>
-<span class="source-line-no">335</span><span id="line-335"> * @param
charset</span>
-<span class="source-line-no">336</span><span id="line-336"> *
the charset for the resource. Must not be null.</span>
-<span class="source-line-no">337</span><span id="line-337"> * @param
format</span>
-<span class="source-line-no">338</span><span id="line-338"> *
the CSVFormat used for CSV parsing. Must not be null.</span>
-<span class="source-line-no">339</span><span id="line-339"> * @return a
new parser</span>
-<span class="source-line-no">340</span><span id="line-340"> * @throws
IllegalArgumentException</span>
-<span class="source-line-no">341</span><span id="line-341"> *
If the parameters of the format are inconsistent or if either url, charset or
format are null.</span>
-<span class="source-line-no">342</span><span id="line-342"> * @throws
IOException</span>
-<span class="source-line-no">343</span><span id="line-343"> *
If an I/O error occurs</span>
-<span class="source-line-no">344</span><span id="line-344"> */</span>
-<span class="source-line-no">345</span><span id="line-345">
@SuppressWarnings("resource")</span>
-<span class="source-line-no">346</span><span id="line-346"> public static
CSVParser parse(final URL url, final Charset charset, final CSVFormat format)
throws IOException {</span>
-<span class="source-line-no">347</span><span id="line-347">
Objects.requireNonNull(url, "url");</span>
-<span class="source-line-no">348</span><span id="line-348">
Objects.requireNonNull(charset, "charset");</span>
-<span class="source-line-no">349</span><span id="line-349">
Objects.requireNonNull(format, "format");</span>
-<span class="source-line-no">350</span><span id="line-350"></span>
-<span class="source-line-no">351</span><span id="line-351"> return new
CSVParser(new InputStreamReader(url.openStream(), charset), format);</span>
-<span class="source-line-no">352</span><span id="line-352"> }</span>
-<span class="source-line-no">353</span><span id="line-353"></span>
-<span class="source-line-no">354</span><span id="line-354"> private String
headerComment;</span>
-<span class="source-line-no">355</span><span id="line-355"></span>
-<span class="source-line-no">356</span><span id="line-356"> private String
trailerComment;</span>
-<span class="source-line-no">357</span><span id="line-357"></span>
-<span class="source-line-no">358</span><span id="line-358"> private final
CSVFormat format;</span>
-<span class="source-line-no">359</span><span id="line-359"></span>
-<span class="source-line-no">360</span><span id="line-360"> private final
Headers headers;</span>
+<span class="source-line-no">204</span><span id="line-204"> /**</span>
+<span class="source-line-no">205</span><span id="line-205"> * Header
names in column order</span>
+<span class="source-line-no">206</span><span id="line-206"> */</span>
+<span class="source-line-no">207</span><span id="line-207"> final
List<String> headerNames;</span>
+<span class="source-line-no">208</span><span id="line-208"></span>
+<span class="source-line-no">209</span><span id="line-209">
Headers(final Map<String, Integer> headerMap, final List<String>
headerNames) {</span>
+<span class="source-line-no">210</span><span id="line-210">
this.headerMap = headerMap;</span>
+<span class="source-line-no">211</span><span id="line-211">
this.headerNames = headerNames;</span>
+<span class="source-line-no">212</span><span id="line-212"> }</span>
+<span class="source-line-no">213</span><span id="line-213"> }</span>
+<span class="source-line-no">214</span><span id="line-214"></span>
+<span class="source-line-no">215</span><span id="line-215"> /**</span>
+<span class="source-line-no">216</span><span id="line-216"> * Creates a
parser for the given {@link File}.</span>
+<span class="source-line-no">217</span><span id="line-217"> *</span>
+<span class="source-line-no">218</span><span id="line-218"> * @param
file</span>
+<span class="source-line-no">219</span><span id="line-219"> * a
CSV file. Must not be null.</span>
+<span class="source-line-no">220</span><span id="line-220"> * @param
charset</span>
+<span class="source-line-no">221</span><span id="line-221"> *
The Charset to decode the given file.</span>
+<span class="source-line-no">222</span><span id="line-222"> * @param
format</span>
+<span class="source-line-no">223</span><span id="line-223"> *
the CSVFormat used for CSV parsing. Must not be null.</span>
+<span class="source-line-no">224</span><span id="line-224"> * @return a
new parser</span>
+<span class="source-line-no">225</span><span id="line-225"> * @throws
IllegalArgumentException</span>
+<span class="source-line-no">226</span><span id="line-226"> *
If the parameters of the format are inconsistent or if either file or format
are null.</span>
+<span class="source-line-no">227</span><span id="line-227"> * @throws
IOException</span>
+<span class="source-line-no">228</span><span id="line-228"> *
If an I/O error occurs</span>
+<span class="source-line-no">229</span><span id="line-229"> * @throws
CSVException Thrown on invalid input.</span>
+<span class="source-line-no">230</span><span id="line-230"> */</span>
+<span class="source-line-no">231</span><span id="line-231"> public static
CSVParser parse(final File file, final Charset charset, final CSVFormat format)
throws IOException {</span>
+<span class="source-line-no">232</span><span id="line-232">
Objects.requireNonNull(file, "file");</span>
+<span class="source-line-no">233</span><span id="line-233"> return
parse(file.toPath(), charset, format);</span>
+<span class="source-line-no">234</span><span id="line-234"> }</span>
+<span class="source-line-no">235</span><span id="line-235"></span>
+<span class="source-line-no">236</span><span id="line-236"> /**</span>
+<span class="source-line-no">237</span><span id="line-237"> * Creates a
CSV parser using the given {@link CSVFormat}.</span>
+<span class="source-line-no">238</span><span id="line-238"> *</span>
+<span class="source-line-no">239</span><span id="line-239"> *
<p></span>
+<span class="source-line-no">240</span><span id="line-240"> * If you do
not read all records from the given {@code reader}, you should call {@link
#close()} on the parser,</span>
+<span class="source-line-no">241</span><span id="line-241"> * unless you
close the {@code reader}.</span>
+<span class="source-line-no">242</span><span id="line-242"> *
</p></span>
+<span class="source-line-no">243</span><span id="line-243"> *</span>
+<span class="source-line-no">244</span><span id="line-244"> * @param
inputStream</span>
+<span class="source-line-no">245</span><span id="line-245"> *
an InputStream containing CSV-formatted input. Must not be null.</span>
+<span class="source-line-no">246</span><span id="line-246"> * @param
charset</span>
+<span class="source-line-no">247</span><span id="line-247"> *
The Charset to decode the given file.</span>
+<span class="source-line-no">248</span><span id="line-248"> * @param
format</span>
+<span class="source-line-no">249</span><span id="line-249"> *
the CSVFormat used for CSV parsing. Must not be null.</span>
+<span class="source-line-no">250</span><span id="line-250"> * @return a
new CSVParser configured with the given reader and format.</span>
+<span class="source-line-no">251</span><span id="line-251"> * @throws
IllegalArgumentException</span>
+<span class="source-line-no">252</span><span id="line-252"> *
If the parameters of the format are inconsistent or if either reader or format
are null.</span>
+<span class="source-line-no">253</span><span id="line-253"> * @throws
IOException</span>
+<span class="source-line-no">254</span><span id="line-254"> *
If there is a problem reading the header or skipping the first record</span>
+<span class="source-line-no">255</span><span id="line-255"> * @throws
CSVException Thrown on invalid input.</span>
+<span class="source-line-no">256</span><span id="line-256"> * @since
1.5</span>
+<span class="source-line-no">257</span><span id="line-257"> */</span>
+<span class="source-line-no">258</span><span id="line-258">
@SuppressWarnings("resource")</span>
+<span class="source-line-no">259</span><span id="line-259"> public static
CSVParser parse(final InputStream inputStream, final Charset charset, final
CSVFormat format)</span>
+<span class="source-line-no">260</span><span id="line-260"> throws
IOException {</span>
+<span class="source-line-no">261</span><span id="line-261">
Objects.requireNonNull(inputStream, "inputStream");</span>
+<span class="source-line-no">262</span><span id="line-262">
Objects.requireNonNull(format, "format");</span>
+<span class="source-line-no">263</span><span id="line-263"> return
parse(new InputStreamReader(inputStream, charset), format);</span>
+<span class="source-line-no">264</span><span id="line-264"> }</span>
+<span class="source-line-no">265</span><span id="line-265"></span>
+<span class="source-line-no">266</span><span id="line-266"> /**</span>
+<span class="source-line-no">267</span><span id="line-267"> * Creates and
returns a parser for the given {@link Path}, which the caller MUST close.</span>
+<span class="source-line-no">268</span><span id="line-268"> *</span>
+<span class="source-line-no">269</span><span id="line-269"> * @param
path</span>
+<span class="source-line-no">270</span><span id="line-270"> * a
CSV file. Must not be null.</span>
+<span class="source-line-no">271</span><span id="line-271"> * @param
charset</span>
+<span class="source-line-no">272</span><span id="line-272"> *
The Charset to decode the given file.</span>
+<span class="source-line-no">273</span><span id="line-273"> * @param
format</span>
+<span class="source-line-no">274</span><span id="line-274"> *
the CSVFormat used for CSV parsing. Must not be null.</span>
+<span class="source-line-no">275</span><span id="line-275"> * @return a
new parser</span>
+<span class="source-line-no">276</span><span id="line-276"> * @throws
IllegalArgumentException</span>
+<span class="source-line-no">277</span><span id="line-277"> *
If the parameters of the format are inconsistent or if either file or format
are null.</span>
+<span class="source-line-no">278</span><span id="line-278"> * @throws
IOException</span>
+<span class="source-line-no">279</span><span id="line-279"> *
If an I/O error occurs</span>
+<span class="source-line-no">280</span><span id="line-280"> * @throws
CSVException Thrown on invalid input.</span>
+<span class="source-line-no">281</span><span id="line-281"> * @since
1.5</span>
+<span class="source-line-no">282</span><span id="line-282"> */</span>
+<span class="source-line-no">283</span><span id="line-283">
@SuppressWarnings("resource")</span>
+<span class="source-line-no">284</span><span id="line-284"> public static
CSVParser parse(final Path path, final Charset charset, final CSVFormat format)
throws IOException {</span>
+<span class="source-line-no">285</span><span id="line-285">
Objects.requireNonNull(path, "path");</span>
+<span class="source-line-no">286</span><span id="line-286">
Objects.requireNonNull(format, "format");</span>
+<span class="source-line-no">287</span><span id="line-287"> return
parse(Files.newInputStream(path), charset, format);</span>
+<span class="source-line-no">288</span><span id="line-288"> }</span>
+<span class="source-line-no">289</span><span id="line-289"></span>
+<span class="source-line-no">290</span><span id="line-290"> /**</span>
+<span class="source-line-no">291</span><span id="line-291"> * Creates a
CSV parser using the given {@link CSVFormat}</span>
+<span class="source-line-no">292</span><span id="line-292"> *</span>
+<span class="source-line-no">293</span><span id="line-293"> *
<p></span>
+<span class="source-line-no">294</span><span id="line-294"> * If you do
not read all records from the given {@code reader}, you should call {@link
#close()} on the parser,</span>
+<span class="source-line-no">295</span><span id="line-295"> * unless you
close the {@code reader}.</span>
+<span class="source-line-no">296</span><span id="line-296"> *
</p></span>
+<span class="source-line-no">297</span><span id="line-297"> *</span>
+<span class="source-line-no">298</span><span id="line-298"> * @param
reader</span>
+<span class="source-line-no">299</span><span id="line-299"> * a
Reader containing CSV-formatted input. Must not be null.</span>
+<span class="source-line-no">300</span><span id="line-300"> * @param
format</span>
+<span class="source-line-no">301</span><span id="line-301"> *
the CSVFormat used for CSV parsing. Must not be null.</span>
+<span class="source-line-no">302</span><span id="line-302"> * @return a
new CSVParser configured with the given reader and format.</span>
+<span class="source-line-no">303</span><span id="line-303"> * @throws
IllegalArgumentException</span>
+<span class="source-line-no">304</span><span id="line-304"> *
If the parameters of the format are inconsistent or if either reader or format
are null.</span>
+<span class="source-line-no">305</span><span id="line-305"> * @throws
IOException</span>
+<span class="source-line-no">306</span><span id="line-306"> *
If there is a problem reading the header or skipping the first record</span>
+<span class="source-line-no">307</span><span id="line-307"> * @throws
CSVException Thrown on invalid input.</span>
+<span class="source-line-no">308</span><span id="line-308"> * @since
1.5</span>
+<span class="source-line-no">309</span><span id="line-309"> */</span>
+<span class="source-line-no">310</span><span id="line-310"> public static
CSVParser parse(final Reader reader, final CSVFormat format) throws IOException
{</span>
+<span class="source-line-no">311</span><span id="line-311"> return new
CSVParser(reader, format);</span>
+<span class="source-line-no">312</span><span id="line-312"> }</span>
+<span class="source-line-no">313</span><span id="line-313"></span>
+<span class="source-line-no">314</span><span id="line-314"> /**</span>
+<span class="source-line-no">315</span><span id="line-315"> * Creates a
parser for the given {@link String}.</span>
+<span class="source-line-no">316</span><span id="line-316"> *</span>
+<span class="source-line-no">317</span><span id="line-317"> * @param
string</span>
+<span class="source-line-no">318</span><span id="line-318"> * a
CSV string. Must not be null.</span>
+<span class="source-line-no">319</span><span id="line-319"> * @param
format</span>
+<span class="source-line-no">320</span><span id="line-320"> *
the CSVFormat used for CSV parsing. Must not be null.</span>
+<span class="source-line-no">321</span><span id="line-321"> * @return a
new parser</span>
+<span class="source-line-no">322</span><span id="line-322"> * @throws
IllegalArgumentException</span>
+<span class="source-line-no">323</span><span id="line-323"> *
If the parameters of the format are inconsistent or if either string or format
are null.</span>
+<span class="source-line-no">324</span><span id="line-324"> * @throws
IOException</span>
+<span class="source-line-no">325</span><span id="line-325"> *
If an I/O error occurs</span>
+<span class="source-line-no">326</span><span id="line-326"> * @throws
CSVException Thrown on invalid input.</span>
+<span class="source-line-no">327</span><span id="line-327"> */</span>
+<span class="source-line-no">328</span><span id="line-328"> public static
CSVParser parse(final String string, final CSVFormat format) throws IOException
{</span>
+<span class="source-line-no">329</span><span id="line-329">
Objects.requireNonNull(string, "string");</span>
+<span class="source-line-no">330</span><span id="line-330">
Objects.requireNonNull(format, "format");</span>
+<span class="source-line-no">331</span><span id="line-331"></span>
+<span class="source-line-no">332</span><span id="line-332"> return new
CSVParser(new StringReader(string), format);</span>
+<span class="source-line-no">333</span><span id="line-333"> }</span>
+<span class="source-line-no">334</span><span id="line-334"></span>
+<span class="source-line-no">335</span><span id="line-335"> /**</span>
+<span class="source-line-no">336</span><span id="line-336"> * Creates and
returns a parser for the given URL, which the caller MUST close.</span>
+<span class="source-line-no">337</span><span id="line-337"> *</span>
+<span class="source-line-no">338</span><span id="line-338"> *
<p></span>
+<span class="source-line-no">339</span><span id="line-339"> * If you do
not read all records from the given {@code url}, you should call {@link
#close()} on the parser, unless</span>
+<span class="source-line-no">340</span><span id="line-340"> * you close
the {@code url}.</span>
+<span class="source-line-no">341</span><span id="line-341"> *
</p></span>
+<span class="source-line-no">342</span><span id="line-342"> *</span>
+<span class="source-line-no">343</span><span id="line-343"> * @param
url</span>
+<span class="source-line-no">344</span><span id="line-344"> * a
URL. Must not be null.</span>
+<span class="source-line-no">345</span><span id="line-345"> * @param
charset</span>
+<span class="source-line-no">346</span><span id="line-346"> *
the charset for the resource. Must not be null.</span>
+<span class="source-line-no">347</span><span id="line-347"> * @param
format</span>
+<span class="source-line-no">348</span><span id="line-348"> *
the CSVFormat used for CSV parsing. Must not be null.</span>
+<span class="source-line-no">349</span><span id="line-349"> * @return a
new parser</span>
+<span class="source-line-no">350</span><span id="line-350"> * @throws
IllegalArgumentException</span>
+<span class="source-line-no">351</span><span id="line-351"> *
If the parameters of the format are inconsistent or if either url, charset or
format are null.</span>
+<span class="source-line-no">352</span><span id="line-352"> * @throws
IOException</span>
+<span class="source-line-no">353</span><span id="line-353"> *
If an I/O error occurs</span>
+<span class="source-line-no">354</span><span id="line-354"> * @throws
CSVException Thrown on invalid input.</span>
+<span class="source-line-no">355</span><span id="line-355"> */</span>
+<span class="source-line-no">356</span><span id="line-356">
@SuppressWarnings("resource")</span>
+<span class="source-line-no">357</span><span id="line-357"> public static
CSVParser parse(final URL url, final Charset charset, final CSVFormat format)
throws IOException {</span>
+<span class="source-line-no">358</span><span id="line-358">
Objects.requireNonNull(url, "url");</span>
+<span class="source-line-no">359</span><span id="line-359">
Objects.requireNonNull(charset, "charset");</span>
+<span class="source-line-no">360</span><span id="line-360">
Objects.requireNonNull(format, "format");</span>
<span class="source-line-no">361</span><span id="line-361"></span>
-<span class="source-line-no">362</span><span id="line-362"> private final
Lexer lexer;</span>
-<span class="source-line-no">363</span><span id="line-363"></span>
-<span class="source-line-no">364</span><span id="line-364"> private final
CSVRecordIterator csvRecordIterator;</span>
-<span class="source-line-no">365</span><span id="line-365"></span>
-<span class="source-line-no">366</span><span id="line-366"> /** A record
buffer for getRecord(). Grows as necessary and is reused. */</span>
-<span class="source-line-no">367</span><span id="line-367"> private final
List<String> recordList = new ArrayList<>();</span>
+<span class="source-line-no">362</span><span id="line-362"> return new
CSVParser(new InputStreamReader(url.openStream(), charset), format);</span>
+<span class="source-line-no">363</span><span id="line-363"> }</span>
+<span class="source-line-no">364</span><span id="line-364"></span>
+<span class="source-line-no">365</span><span id="line-365"> private String
headerComment;</span>
+<span class="source-line-no">366</span><span id="line-366"></span>
+<span class="source-line-no">367</span><span id="line-367"> private String
trailerComment;</span>
<span class="source-line-no">368</span><span id="line-368"></span>
-<span class="source-line-no">369</span><span id="line-369"> /**</span>
-<span class="source-line-no">370</span><span id="line-370"> * The next
record number to assign.</span>
-<span class="source-line-no">371</span><span id="line-371"> */</span>
-<span class="source-line-no">372</span><span id="line-372"> private long
recordNumber;</span>
-<span class="source-line-no">373</span><span id="line-373"></span>
-<span class="source-line-no">374</span><span id="line-374"> /**</span>
-<span class="source-line-no">375</span><span id="line-375"> * Lexer offset
when the parser does not start parsing at the beginning of the source. Usually
used in combination</span>
-<span class="source-line-no">376</span><span id="line-376"> * with {@link
#recordNumber}.</span>
-<span class="source-line-no">377</span><span id="line-377"> */</span>
-<span class="source-line-no">378</span><span id="line-378"> private final
long characterOffset;</span>
+<span class="source-line-no">369</span><span id="line-369"> private final
CSVFormat format;</span>
+<span class="source-line-no">370</span><span id="line-370"></span>
+<span class="source-line-no">371</span><span id="line-371"> private final
Headers headers;</span>
+<span class="source-line-no">372</span><span id="line-372"></span>
+<span class="source-line-no">373</span><span id="line-373"> private final
Lexer lexer;</span>
+<span class="source-line-no">374</span><span id="line-374"></span>
+<span class="source-line-no">375</span><span id="line-375"> private final
CSVRecordIterator csvRecordIterator;</span>
+<span class="source-line-no">376</span><span id="line-376"></span>
+<span class="source-line-no">377</span><span id="line-377"> /** A record
buffer for getRecord(). Grows as necessary and is reused. */</span>
+<span class="source-line-no">378</span><span id="line-378"> private final
List<String> recordList = new ArrayList<>();</span>
<span class="source-line-no">379</span><span id="line-379"></span>
-<span class="source-line-no">380</span><span id="line-380"> private final
Token reusableToken = new Token();</span>
-<span class="source-line-no">381</span><span id="line-381"></span>
-<span class="source-line-no">382</span><span id="line-382"> /**</span>
-<span class="source-line-no">383</span><span id="line-383"> * Constructs a
new instance using the given {@link CSVFormat}</span>
-<span class="source-line-no">384</span><span id="line-384"> *</span>
-<span class="source-line-no">385</span><span id="line-385"> *
<p></span>
-<span class="source-line-no">386</span><span id="line-386"> * If you do
not read all records from the given {@code reader}, you should call {@link
#close()} on the parser,</span>
-<span class="source-line-no">387</span><span id="line-387"> * unless you
close the {@code reader}.</span>
-<span class="source-line-no">388</span><span id="line-388"> *
</p></span>
-<span class="source-line-no">389</span><span id="line-389"> *</span>
-<span class="source-line-no">390</span><span id="line-390"> * @param
reader</span>
-<span class="source-line-no">391</span><span id="line-391"> * a
Reader containing CSV-formatted input. Must not be null.</span>
-<span class="source-line-no">392</span><span id="line-392"> * @param
format</span>
-<span class="source-line-no">393</span><span id="line-393"> *
the CSVFormat used for CSV parsing. Must not be null.</span>
-<span class="source-line-no">394</span><span id="line-394"> * @throws
IllegalArgumentException</span>
-<span class="source-line-no">395</span><span id="line-395"> *
If the parameters of the format are inconsistent or if either reader or format
are null.</span>
-<span class="source-line-no">396</span><span id="line-396"> * @throws
IOException</span>
-<span class="source-line-no">397</span><span id="line-397"> *
If there is a problem reading the header or skipping the first record</span>
-<span class="source-line-no">398</span><span id="line-398"> */</span>
-<span class="source-line-no">399</span><span id="line-399"> public
CSVParser(final Reader reader, final CSVFormat format) throws IOException
{</span>
-<span class="source-line-no">400</span><span id="line-400">
this(reader, format, 0, 1);</span>
-<span class="source-line-no">401</span><span id="line-401"> }</span>
-<span class="source-line-no">402</span><span id="line-402"></span>
-<span class="source-line-no">403</span><span id="line-403"> /**</span>
-<span class="source-line-no">404</span><span id="line-404"> * Constructs a
new instance using the given {@link CSVFormat}</span>
-<span class="source-line-no">405</span><span id="line-405"> *</span>
-<span class="source-line-no">406</span><span id="line-406"> *
<p></span>
-<span class="source-line-no">407</span><span id="line-407"> * If you do
not read all records from the given {@code reader}, you should call {@link
#close()} on the parser,</span>
-<span class="source-line-no">408</span><span id="line-408"> * unless you
close the {@code reader}.</span>
-<span class="source-line-no">409</span><span id="line-409"> *
</p></span>
-<span class="source-line-no">410</span><span id="line-410"> *</span>
-<span class="source-line-no">411</span><span id="line-411"> * @param
reader</span>
-<span class="source-line-no">412</span><span id="line-412"> * a
Reader containing CSV-formatted input. Must not be null.</span>
-<span class="source-line-no">413</span><span id="line-413"> * @param
format</span>
-<span class="source-line-no">414</span><span id="line-414"> *
the CSVFormat used for CSV parsing. Must not be null.</span>
-<span class="source-line-no">415</span><span id="line-415"> * @param
characterOffset</span>
-<span class="source-line-no">416</span><span id="line-416"> *
Lexer offset when the parser does not start parsing at the beginning of the
source.</span>
-<span class="source-line-no">417</span><span id="line-417"> * @param
recordNumber</span>
-<span class="source-line-no">418</span><span id="line-418"> *
The next record number to assign</span>
-<span class="source-line-no">419</span><span id="line-419"> * @throws
IllegalArgumentException</span>
-<span class="source-line-no">420</span><span id="line-420"> *
If the parameters of the format are inconsistent or if either the reader or
format is null.</span>
-<span class="source-line-no">421</span><span id="line-421"> * @throws
IOException</span>
-<span class="source-line-no">422</span><span id="line-422"> *
If there is a problem reading the header or skipping the first record</span>
-<span class="source-line-no">423</span><span id="line-423"> * @since
1.1</span>
-<span class="source-line-no">424</span><span id="line-424"> */</span>
-<span class="source-line-no">425</span><span id="line-425">
@SuppressWarnings("resource")</span>
-<span class="source-line-no">426</span><span id="line-426"> public
CSVParser(final Reader reader, final CSVFormat format, final long
characterOffset, final long recordNumber)</span>
-<span class="source-line-no">427</span><span id="line-427"> throws
IOException {</span>
-<span class="source-line-no">428</span><span id="line-428">
Objects.requireNonNull(reader, "reader");</span>
-<span class="source-line-no">429</span><span id="line-429">
Objects.requireNonNull(format, "format");</span>
-<span class="source-line-no">430</span><span id="line-430"> this.format
= format.copy();</span>
-<span class="source-line-no">431</span><span id="line-431"> this.lexer
= new Lexer(format, new ExtendedBufferedReader(reader));</span>
-<span class="source-line-no">432</span><span id="line-432">
this.csvRecordIterator = new CSVRecordIterator();</span>
-<span class="source-line-no">433</span><span id="line-433">
this.headers = createHeaders();</span>
-<span class="source-line-no">434</span><span id="line-434">
this.characterOffset = characterOffset;</span>
-<span class="source-line-no">435</span><span id="line-435">
this.recordNumber = recordNumber - 1;</span>
-<span class="source-line-no">436</span><span id="line-436"> }</span>
-<span class="source-line-no">437</span><span id="line-437"></span>
-<span class="source-line-no">438</span><span id="line-438"> private void
addRecordValue(final boolean lastRecord) {</span>
-<span class="source-line-no">439</span><span id="line-439"> final
String input = format.trim(reusableToken.content.toString());</span>
-<span class="source-line-no">440</span><span id="line-440"> if
(lastRecord && input.isEmpty() &&
format.getTrailingDelimiter()) {</span>
-<span class="source-line-no">441</span><span id="line-441">
return;</span>
-<span class="source-line-no">442</span><span id="line-442"> }</span>
-<span class="source-line-no">443</span><span id="line-443">
recordList.add(handleNull(input));</span>
-<span class="source-line-no">444</span><span id="line-444"> }</span>
-<span class="source-line-no">445</span><span id="line-445"></span>
-<span class="source-line-no">446</span><span id="line-446"> /**</span>
-<span class="source-line-no">447</span><span id="line-447"> * Closes
resources.</span>
-<span class="source-line-no">448</span><span id="line-448"> *</span>
-<span class="source-line-no">449</span><span id="line-449"> * @throws
IOException</span>
-<span class="source-line-no">450</span><span id="line-450"> *
If an I/O error occurs</span>
-<span class="source-line-no">451</span><span id="line-451"> */</span>
-<span class="source-line-no">452</span><span id="line-452"> @Override</span>
-<span class="source-line-no">453</span><span id="line-453"> public void
close() throws IOException {</span>
-<span class="source-line-no">454</span><span id="line-454">
lexer.close();</span>
-<span class="source-line-no">455</span><span id="line-455"> }</span>
-<span class="source-line-no">456</span><span id="line-456"></span>
-<span class="source-line-no">457</span><span id="line-457"> private
Map<String, Integer> createEmptyHeaderMap() {</span>
-<span class="source-line-no">458</span><span id="line-458"> return
format.getIgnoreHeaderCase() ?</span>
-<span class="source-line-no">459</span><span id="line-459"> new
TreeMap<>(String.CASE_INSENSITIVE_ORDER) :</span>
-<span class="source-line-no">460</span><span id="line-460"> new
LinkedHashMap<>();</span>
-<span class="source-line-no">461</span><span id="line-461"> }</span>
-<span class="source-line-no">462</span><span id="line-462"></span>
-<span class="source-line-no">463</span><span id="line-463"> /**</span>
-<span class="source-line-no">464</span><span id="line-464"> * Creates the
name to index mapping if the format defines a header.</span>
-<span class="source-line-no">465</span><span id="line-465"> *</span>
-<span class="source-line-no">466</span><span id="line-466"> * @return null
if the format has no header.</span>
-<span class="source-line-no">467</span><span id="line-467"> * @throws
IOException if there is a problem reading the header or skipping the first
record</span>
-<span class="source-line-no">468</span><span id="line-468"> */</span>
-<span class="source-line-no">469</span><span id="line-469"> private Headers
createHeaders() throws IOException {</span>
-<span class="source-line-no">470</span><span id="line-470">
Map<String, Integer> hdrMap = null;</span>
-<span class="source-line-no">471</span><span id="line-471">
List<String> headerNames = null;</span>
-<span class="source-line-no">472</span><span id="line-472"> final
String[] formatHeader = format.getHeader();</span>
-<span class="source-line-no">473</span><span id="line-473"> if
(formatHeader != null) {</span>
-<span class="source-line-no">474</span><span id="line-474"> hdrMap
= createEmptyHeaderMap();</span>
-<span class="source-line-no">475</span><span id="line-475">
String[] headerRecord = null;</span>
-<span class="source-line-no">476</span><span id="line-476"> if
(formatHeader.length == 0) {</span>
-<span class="source-line-no">477</span><span id="line-477"> //
read the header from the first line of the file</span>
-<span class="source-line-no">478</span><span id="line-478">
final CSVRecord nextRecord = nextRecord();</span>
-<span class="source-line-no">479</span><span id="line-479"> if
(nextRecord != null) {</span>
-<span class="source-line-no">480</span><span id="line-480">
headerRecord = nextRecord.values();</span>
-<span class="source-line-no">481</span><span id="line-481">
headerComment = nextRecord.getComment();</span>
-<span class="source-line-no">482</span><span id="line-482">
}</span>
-<span class="source-line-no">483</span><span id="line-483"> } else
{</span>
-<span class="source-line-no">484</span><span id="line-484"> if
(format.getSkipHeaderRecord()) {</span>
-<span class="source-line-no">485</span><span id="line-485">
final CSVRecord nextRecord = nextRecord();</span>
-<span class="source-line-no">486</span><span id="line-486">
if (nextRecord != null) {</span>
-<span class="source-line-no">487</span><span id="line-487">
headerComment = nextRecord.getComment();</span>
-<span class="source-line-no">488</span><span id="line-488">
}</span>
-<span class="source-line-no">489</span><span id="line-489">
}</span>
-<span class="source-line-no">490</span><span id="line-490">
headerRecord = formatHeader;</span>
-<span class="source-line-no">491</span><span id="line-491"> }</span>
-<span class="source-line-no">492</span><span id="line-492"></span>
-<span class="source-line-no">493</span><span id="line-493"> //
build the name to index mappings</span>
-<span class="source-line-no">494</span><span id="line-494"> if
(headerRecord != null) {</span>
-<span class="source-line-no">495</span><span id="line-495"> //
Track an occurrence of a null, empty or blank header.</span>
-<span class="source-line-no">496</span><span id="line-496">
boolean observedMissing = false;</span>
-<span class="source-line-no">497</span><span id="line-497"> for
(int i = 0; i < headerRecord.length; i++) {</span>
-<span class="source-line-no">498</span><span id="line-498">
final String header = headerRecord[i];</span>
-<span class="source-line-no">499</span><span id="line-499">
final boolean blankHeader = CSVFormat.isBlank(header);</span>
-<span class="source-line-no">500</span><span id="line-500">
if (blankHeader && !format.getAllowMissingColumnNames()) {</span>
-<span class="source-line-no">501</span><span id="line-501">
throw new IllegalArgumentException(</span>
-<span class="source-line-no">502</span><span id="line-502">
"A header name is missing in " + Arrays.toString(headerRecord));</span>
-<span class="source-line-no">503</span><span id="line-503">
}</span>
-<span class="source-line-no">504</span><span id="line-504"></span>
-<span class="source-line-no">505</span><span id="line-505">
final boolean containsHeader = blankHeader ? observedMissing :
hdrMap.containsKey(header);</span>
-<span class="source-line-no">506</span><span id="line-506">
final DuplicateHeaderMode headerMode = format.getDuplicateHeaderMode();</span>
-<span class="source-line-no">507</span><span id="line-507">
final boolean duplicatesAllowed = headerMode ==
DuplicateHeaderMode.ALLOW_ALL;</span>
-<span class="source-line-no">508</span><span id="line-508">
final boolean emptyDuplicatesAllowed = headerMode ==
DuplicateHeaderMode.ALLOW_EMPTY;</span>
-<span class="source-line-no">509</span><span id="line-509"></span>
-<span class="source-line-no">510</span><span id="line-510">
if (containsHeader && !duplicatesAllowed && !(blankHeader
&& emptyDuplicatesAllowed)) {</span>
-<span class="source-line-no">511</span><span id="line-511">
throw new IllegalArgumentException(</span>
-<span class="source-line-no">512</span><span id="line-512">
String.format(</span>
-<span class="source-line-no">513</span><span id="line-513">
"The header contains a duplicate name: \"%s\" in %s. If this is
valid then use CSVFormat.Builder.setDuplicateHeaderMode().",</span>
-<span class="source-line-no">514</span><span id="line-514">
header, Arrays.toString(headerRecord)));</span>
-<span class="source-line-no">515</span><span id="line-515">
}</span>
-<span class="source-line-no">516</span><span id="line-516">
observedMissing |= blankHeader;</span>
-<span class="source-line-no">517</span><span id="line-517">
if (header != null) {</span>
-<span class="source-line-no">518</span><span id="line-518">
hdrMap.put(header, Integer.valueOf(i));</span>
-<span class="source-line-no">519</span><span id="line-519">
if (headerNames == null) {</span>
-<span class="source-line-no">520</span><span id="line-520">
headerNames = new ArrayList<>(headerRecord.length);</span>
-<span class="source-line-no">521</span><span id="line-521">
}</span>
-<span class="source-line-no">522</span><span id="line-522">
headerNames.add(header);</span>
-<span class="source-line-no">523</span><span id="line-523">
}</span>
-<span class="source-line-no">524</span><span id="line-524">
}</span>
-<span class="source-line-no">525</span><span id="line-525"> }</span>
-<span class="source-line-no">526</span><span id="line-526"> }</span>
-<span class="source-line-no">527</span><span id="line-527"> // Make
header names Collection immutable</span>
-<span class="source-line-no">528</span><span id="line-528"> return new
Headers(hdrMap, headerNames == null ? Collections.emptyList() :
Collections.unmodifiableList(headerNames));</span>
-<span class="source-line-no">529</span><span id="line-529"> }</span>
-<span class="source-line-no">530</span><span id="line-530"></span>
-<span class="source-line-no">531</span><span id="line-531"> /**</span>
-<span class="source-line-no">532</span><span id="line-532"> * Gets the
current line number in the input stream.</span>
-<span class="source-line-no">533</span><span id="line-533"> *</span>
-<span class="source-line-no">534</span><span id="line-534"> *
<p></span>
-<span class="source-line-no">535</span><span id="line-535"> *
<strong>ATTENTION:</strong> If your CSV input has multi-line
values, the returned number does not correspond to</span>
-<span class="source-line-no">536</span><span id="line-536"> * the record
number.</span>
-<span class="source-line-no">537</span><span id="line-537"> *
</p></span>
-<span class="source-line-no">538</span><span id="line-538"> *</span>
-<span class="source-line-no">539</span><span id="line-539"> * @return
current line number</span>
-<span class="source-line-no">540</span><span id="line-540"> */</span>
-<span class="source-line-no">541</span><span id="line-541"> public long
getCurrentLineNumber() {</span>
-<span class="source-line-no">542</span><span id="line-542"> return
lexer.getCurrentLineNumber();</span>
+<span class="source-line-no">380</span><span id="line-380"> /**</span>
+<span class="source-line-no">381</span><span id="line-381"> * The next
record number to assign.</span>
+<span class="source-line-no">382</span><span id="line-382"> */</span>
+<span class="source-line-no">383</span><span id="line-383"> private long
recordNumber;</span>
+<span class="source-line-no">384</span><span id="line-384"></span>
+<span class="source-line-no">385</span><span id="line-385"> /**</span>
+<span class="source-line-no">386</span><span id="line-386"> * Lexer offset
when the parser does not start parsing at the beginning of the source. Usually
used in combination</span>
+<span class="source-line-no">387</span><span id="line-387"> * with {@link
#recordNumber}.</span>
+<span class="source-line-no">388</span><span id="line-388"> */</span>
+<span class="source-line-no">389</span><span id="line-389"> private final
long characterOffset;</span>
+<span class="source-line-no">390</span><span id="line-390"></span>
+<span class="source-line-no">391</span><span id="line-391"> private final
Token reusableToken = new Token();</span>
+<span class="source-line-no">392</span><span id="line-392"></span>
+<span class="source-line-no">393</span><span id="line-393"> /**</span>
+<span class="source-line-no">394</span><span id="line-394"> * Constructs a
new instance using the given {@link CSVFormat}</span>
+<span class="source-line-no">395</span><span id="line-395"> *</span>
+<span class="source-line-no">396</span><span id="line-396"> *
<p></span>
+<span class="source-line-no">397</span><span id="line-397"> * If you do
not read all records from the given {@code reader}, you should call {@link
#close()} on the parser,</span>
+<span class="source-line-no">398</span><span id="line-398"> * unless you
close the {@code reader}.</span>
+<span class="source-line-no">399</span><span id="line-399"> *
</p></span>
+<span class="source-line-no">400</span><span id="line-400"> *</span>
+<span class="source-line-no">401</span><span id="line-401"> * @param
reader</span>
+<span class="source-line-no">402</span><span id="line-402"> * a
Reader containing CSV-formatted input. Must not be null.</span>
+<span class="source-line-no">403</span><span id="line-403"> * @param
format</span>
+<span class="source-line-no">404</span><span id="line-404"> *
the CSVFormat used for CSV parsing. Must not be null.</span>
+<span class="source-line-no">405</span><span id="line-405"> * @throws
IllegalArgumentException</span>
+<span class="source-line-no">406</span><span id="line-406"> *
If the parameters of the format are inconsistent or if either reader or format
are null.</span>
+<span class="source-line-no">407</span><span id="line-407"> * @throws
IOException</span>
+<span class="source-line-no">408</span><span id="line-408"> *
If there is a problem reading the header or skipping the first record</span>
+<span class="source-line-no">409</span><span id="line-409"> * @throws
CSVException Thrown on invalid input.</span>
+<span class="source-line-no">410</span><span id="line-410"> */</span>
+<span class="source-line-no">411</span><span id="line-411"> public
CSVParser(final Reader reader, final CSVFormat format) throws IOException
{</span>
+<span class="source-line-no">412</span><span id="line-412">
this(reader, format, 0, 1);</span>
+<span class="source-line-no">413</span><span id="line-413"> }</span>
+<span class="source-line-no">414</span><span id="line-414"></span>
+<span class="source-line-no">415</span><span id="line-415"> /**</span>
+<span class="source-line-no">416</span><span id="line-416"> * Constructs a
new instance using the given {@link CSVFormat}</span>
+<span class="source-line-no">417</span><span id="line-417"> *</span>
+<span class="source-line-no">418</span><span id="line-418"> *
<p></span>
+<span class="source-line-no">419</span><span id="line-419"> * If you do
not read all records from the given {@code reader}, you should call {@link
#close()} on the parser,</span>
+<span class="source-line-no">420</span><span id="line-420"> * unless you
close the {@code reader}.</span>
+<span class="source-line-no">421</span><span id="line-421"> *
</p></span>
+<span class="source-line-no">422</span><span id="line-422"> *</span>
+<span class="source-line-no">423</span><span id="line-423"> * @param
reader</span>
+<span class="source-line-no">424</span><span id="line-424"> * a
Reader containing CSV-formatted input. Must not be null.</span>
+<span class="source-line-no">425</span><span id="line-425"> * @param
format</span>
+<span class="source-line-no">426</span><span id="line-426"> *
the CSVFormat used for CSV parsing. Must not be null.</span>
+<span class="source-line-no">427</span><span id="line-427"> * @param
characterOffset</span>
+<span class="source-line-no">428</span><span id="line-428"> *
Lexer offset when the parser does not start parsing at the beginning of the
source.</span>
+<span class="source-line-no">429</span><span id="line-429"> * @param
recordNumber</span>
+<span class="source-line-no">430</span><span id="line-430"> *
The next record number to assign</span>
+<span class="source-line-no">431</span><span id="line-431"> * @throws
IllegalArgumentException</span>
+<span class="source-line-no">432</span><span id="line-432"> *
If the parameters of the format are inconsistent or if either the reader or
format is null.</span>
+<span class="source-line-no">433</span><span id="line-433"> * @throws
IOException</span>
+<span class="source-line-no">434</span><span id="line-434"> *
If there is a problem reading the header or skipping the first record</span>
+<span class="source-line-no">435</span><span id="line-435"> * @throws
CSVException Thrown on invalid input.</span>
+<span class="source-line-no">436</span><span id="line-436"> * @since
1.1</span>
+<span class="source-line-no">437</span><span id="line-437"> */</span>
+<span class="source-line-no">438</span><span id="line-438">
@SuppressWarnings("resource")</span>
+<span class="source-line-no">439</span><span id="line-439"> public
CSVParser(final Reader reader, final CSVFormat format, final long
characterOffset, final long recordNumber)</span>
+<span class="source-line-no">440</span><span id="line-440"> throws
IOException {</span>
+<span class="source-line-no">441</span><span id="line-441">
Objects.requireNonNull(reader, "reader");</span>
+<span class="source-line-no">442</span><span id="line-442">
Objects.requireNonNull(format, "format");</span>
+<span class="source-line-no">443</span><span id="line-443"> this.format
= format.copy();</span>
+<span class="source-line-no">444</span><span id="line-444"> this.lexer
= new Lexer(format, new ExtendedBufferedReader(reader));</span>
+<span class="source-line-no">445</span><span id="line-445">
this.csvRecordIterator = new CSVRecordIterator();</span>
+<span class="source-line-no">446</span><span id="line-446">
this.headers = createHeaders();</span>
+<span class="source-line-no">447</span><span id="line-447">
this.characterOffset = characterOffset;</span>
+<span class="source-line-no">448</span><span id="line-448">
this.recordNumber = recordNumber - 1;</span>
+<span class="source-line-no">449</span><span id="line-449"> }</span>
+<span class="source-line-no">450</span><span id="line-450"></span>
+<span class="source-line-no">451</span><span id="line-451"> private void
addRecordValue(final boolean lastRecord) {</span>
+<span class="source-line-no">452</span><span id="line-452"> final
String input = format.trim(reusableToken.content.toString());</span>
+<span class="source-line-no">453</span><span id="line-453"> if
(lastRecord && input.isEmpty() &&
format.getTrailingDelimiter()) {</span>
+<span class="source-line-no">454</span><span id="line-454">
return;</span>
+<span class="source-line-no">455</span><span id="line-455"> }</span>
+<span class="source-line-no">456</span><span id="line-456">
recordList.add(handleNull(input));</span>
+<span class="source-line-no">457</span><span id="line-457"> }</span>
+<span class="source-line-no">458</span><span id="line-458"></span>
+<span class="source-line-no">459</span><span id="line-459"> /**</span>
+<span class="source-line-no">460</span><span id="line-460"> * Closes
resources.</span>
+<span class="source-line-no">461</span><span id="line-461"> *</span>
+<span class="source-line-no">462</span><span id="line-462"> * @throws
IOException</span>
+<span class="source-line-no">463</span><span id="line-463"> *
If an I/O error occurs</span>
+<span class="source-line-no">464</span><span id="line-464"> */</span>
+<span class="source-line-no">465</span><span id="line-465"> @Override</span>
+<span class="source-line-no">466</span><span id="line-466"> public void
close() throws IOException {</span>
+<span class="source-line-no">467</span><span id="line-467">
lexer.close();</span>
+<span class="source-line-no">468</span><span id="line-468"> }</span>
+<span class="source-line-no">469</span><span id="line-469"></span>
+<span class="source-line-no">470</span><span id="line-470"> private
Map<String, Integer> createEmptyHeaderMap() {</span>
+<span class="source-line-no">471</span><span id="line-471"> return
format.getIgnoreHeaderCase() ?</span>
+<span class="source-line-no">472</span><span id="line-472"> new
TreeMap<>(String.CASE_INSENSITIVE_ORDER) :</span>
+<span class="source-line-no">473</span><span id="line-473"> new
LinkedHashMap<>();</span>
+<span class="source-line-no">474</span><span id="line-474"> }</span>
+<span class="source-line-no">475</span><span id="line-475"></span>
+<span class="source-line-no">476</span><span id="line-476"> /**</span>
+<span class="source-line-no">477</span><span id="line-477"> * Creates the
name to index mapping if the format defines a header.</span>
+<span class="source-line-no">478</span><span id="line-478"> *</span>
+<span class="source-line-no">479</span><span id="line-479"> * @return null
if the format has no header.</span>
+<span class="source-line-no">480</span><span id="line-480"> * @throws
IOException if there is a problem reading the header or skipping the first
record</span>
+<span class="source-line-no">481</span><span id="line-481"> * @throws
CSVException Thrown on invalid input.</span>
+<span class="source-line-no">482</span><span id="line-482"> */</span>
+<span class="source-line-no">483</span><span id="line-483"> private Headers
createHeaders() throws IOException {</span>
+<span class="source-line-no">484</span><span id="line-484">
Map<String, Integer> hdrMap = null;</span>
+<span class="source-line-no">485</span><span id="line-485">
List<String> headerNames = null;</span>
+<span class="source-line-no">486</span><span id="line-486"> final
String[] formatHeader = format.getHeader();</span>
+<span class="source-line-no">487</span><span id="line-487"> if
(formatHeader != null) {</span>
+<span class="source-line-no">488</span><span id="line-488"> hdrMap
= createEmptyHeaderMap();</span>
+<span class="source-line-no">489</span><span id="line-489">
String[] headerRecord = null;</span>
+<span class="source-line-no">490</span><span id="line-490"> if
(formatHeader.length == 0) {</span>
+<span class="source-line-no">491</span><span id="line-491"> //
read the header from the first line of the file</span>
+<span class="source-line-no">492</span><span id="line-492">
final CSVRecord nextRecord = nextRecord();</span>
+<span class="source-line-no">493</span><span id="line-493"> if
(nextRecord != null) {</span>
+<span class="source-line-no">494</span><span id="line-494">
headerRecord = nextRecord.values();</span>
+<span class="source-line-no">495</span><span id="line-495">
headerComment = nextRecord.getComment();</span>
+<span class="source-line-no">496</span><span id="line-496">
}</span>
+<span class="source-line-no">497</span><span id="line-497"> } else
{</span>
+<span class="source-line-no">498</span><span id="line-498"> if
(format.getSkipHeaderRecord()) {</span>
+<span class="source-line-no">499</span><span id="line-499">
final CSVRecord nextRecord = nextRecord();</span>
+<span class="source-line-no">500</span><span id="line-500">
if (nextRecord != null) {</span>
+<span class="source-line-no">501</span><span id="line-501">
headerComment = nextRecord.getComment();</span>
+<span class="source-line-no">502</span><span id="line-502">
}</span>
+<span class="source-line-no">503</span><span id="line-503">
}</span>
+<span class="source-line-no">504</span><span id="line-504">
headerRecord = formatHeader;</span>
+<span class="source-line-no">505</span><span id="line-505"> }</span>
+<span class="source-line-no">506</span><span id="line-506"></span>
+<span class="source-line-no">507</span><span id="line-507"> //
build the name to index mappings</span>
+<span class="source-line-no">508</span><span id="line-508"> if
(headerRecord != null) {</span>
+<span class="source-line-no">509</span><span id="line-509"> //
Track an occurrence of a null, empty or blank header.</span>
+<span class="source-line-no">510</span><span id="line-510">
boolean observedMissing = false;</span>
+<span class="source-line-no">511</span><span id="line-511"> for
(int i = 0; i < headerRecord.length; i++) {</span>
+<span class="source-line-no">512</span><span id="line-512">
final String header = headerRecord[i];</span>
+<span class="source-line-no">513</span><span id="line-513">
final boolean blankHeader = CSVFormat.isBlank(header);</span>
+<span class="source-line-no">514</span><span id="line-514">
if (blankHeader && !format.getAllowMissingColumnNames()) {</span>
+<span class="source-line-no">515</span><span id="line-515">
throw new IllegalArgumentException(</span>
+<span class="source-line-no">516</span><span id="line-516">
"A header name is missing in " + Arrays.toString(headerRecord));</span>
+<span class="source-line-no">517</span><span id="line-517">
}</span>
+<span class="source-line-no">518</span><span id="line-518"></span>
+<span class="source-line-no">519</span><span id="line-519">
final boolean containsHeader = blankHeader ? observedMissing :
hdrMap.containsKey(header);</span>
+<span class="source-line-no">520</span><span id="line-520">
final DuplicateHeaderMode headerMode = format.getDuplicateHeaderMode();</span>
+<span class="source-line-no">521</span><span id="line-521">
final boolean duplicatesAllowed = headerMode ==
DuplicateHeaderMode.ALLOW_ALL;</span>
+<span class="source-line-no">522</span><span id="line-522">
final boolean emptyDuplicatesAllowed = headerMode ==
DuplicateHeaderMode.ALLOW_EMPTY;</span>
+<span class="source-line-no">523</span><span id="line-523"></span>
+<span class="source-line-no">524</span><span id="line-524">
if (containsHeader && !duplicatesAllowed && !(blankHeader
&& emptyDuplicatesAllowed)) {</span>
+<span class="source-line-no">525</span><span id="line-525">
throw new IllegalArgumentException(</span>
+<span class="source-line-no">526</span><span id="line-526">
String.format(</span>
+<span class="source-line-no">527</span><span id="line-527">
"The header contains a duplicate name: \"%s\" in %s. If this is
valid then use CSVFormat.Builder.setDuplicateHeaderMode().",</span>
+<span class="source-line-no">528</span><span id="line-528">
header, Arrays.toString(headerRecord)));</span>
+<span class="source-line-no">529</span><span id="line-529">
}</span>
+<span class="source-line-no">530</span><span id="line-530">
observedMissing |= blankHeader;</span>
+<span class="source-line-no">531</span><span id="line-531">
if (header != null) {</span>
+<span class="source-line-no">532</span><span id="line-532">
hdrMap.put(header, Integer.valueOf(i)); // N.B. Explicit (un)boxing is
intentional</span>
+<span class="source-line-no">533</span><span id="line-533">
if (headerNames == null) {</span>
+<span class="source-line-no">534</span><span id="line-534">
headerNames = new ArrayList<>(headerRecord.length);</span>
+<span class="source-line-no">535</span><span id="line-535">
}</span>
+<span class="source-line-no">536</span><span id="line-536">
headerNames.add(header);</span>
+<span class="source-line-no">537</span><span id="line-537">
}</span>
+<span class="source-line-no">538</span><span id="line-538">
}</span>
+<span class="source-line-no">539</span><span id="line-539"> }</span>
+<span class="source-line-no">540</span><span id="line-540"> }</span>
+<span class="source-line-no">541</span><span id="line-541"> // Make
header names Collection immutable</span>
+<span class="source-line-no">542</span><span id="line-542"> return new
Headers(hdrMap, headerNames == null ? Collections.emptyList() :
Collections.unmodifiableList(headerNames));</span>
<span class="source-line-no">543</span><span id="line-543"> }</span>
<span class="source-line-no">544</span><span id="line-544"></span>
<span class="source-line-no">545</span><span id="line-545"> /**</span>
-<span class="source-line-no">546</span><span id="line-546"> * Gets the
first end-of-line string encountered.</span>
+<span class="source-line-no">546</span><span id="line-546"> * Gets the
current line number in the input stream.</span>
<span class="source-line-no">547</span><span id="line-547"> *</span>
-<span class="source-line-no">548</span><span id="line-548"> * @return the
first end-of-line string</span>
-<span class="source-line-no">549</span><span id="line-549"> * @since
1.5</span>
-<span class="source-line-no">550</span><span id="line-550"> */</span>
-<span class="source-line-no">551</span><span id="line-551"> public String
getFirstEndOfLine() {</span>
-<span class="source-line-no">552</span><span id="line-552"> return
lexer.getFirstEol();</span>
-<span class="source-line-no">553</span><span id="line-553"> }</span>
-<span class="source-line-no">554</span><span id="line-554"></span>
-<span class="source-line-no">555</span><span id="line-555"> /**</span>
-<span class="source-line-no">556</span><span id="line-556"> * Gets the
header comment, if any.</span>
-<span class="source-line-no">557</span><span id="line-557"> * The header
comment appears before the header record.</span>
-<span class="source-line-no">558</span><span id="line-558"> *</span>
-<span class="source-line-no">559</span><span id="line-559"> * @return the
header comment for this stream, or null if no comment is available.</span>
-<span class="source-line-no">560</span><span id="line-560"> * @since
1.10.0</span>
-<span class="source-line-no">561</span><span id="line-561"> */</span>
-<span class="source-line-no">562</span><span id="line-562"> public String
getHeaderComment() {</span>
[... 524 lines stripped ...]