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"> * &lt;/p&gt;</span>
 <span class="source-line-no">074</span><span id="line-74"> * &lt;pre&gt;</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"> * 
&lt;/pre&gt;</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"> * &lt;/p&gt;</span>
 <span class="source-line-no">084</span><span id="line-84"> *</span>
-<span class="source-line-no">085</span><span id="line-85"> * &lt;pre&gt;</span>
-<span class="source-line-no">086</span><span id="line-86"> * File csvData = 
new File(&amp;quot;/path/to/csv&amp;quot;);</span>
+<span class="source-line-no">085</span><span id="line-85"> * 
&lt;pre&gt;{@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"> * 
&lt;/pre&gt;</span>
 <span class="source-line-no">092</span><span id="line-92"> *</span>
 <span class="source-line-no">093</span><span id="line-93"> * &lt;p&gt;</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"> * &lt;/p&gt;</span>
 <span class="source-line-no">118</span><span id="line-118"> *</span>
-<span class="source-line-no">119</span><span id="line-119"> * 
&lt;pre&gt;</span>
-<span class="source-line-no">120</span><span id="line-120"> * Reader in = new 
StringReader(&amp;quot;a;b\nc;d&amp;quot;);</span>
+<span class="source-line-no">119</span><span id="line-119"> * 
&lt;pre&gt;{@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&amp;lt;CSVRecord&amp;gt; list = parser.getRecords();</span>
-<span class="source-line-no">123</span><span id="line-123"> * 
&lt;/pre&gt;</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"> * 
}&lt;/pre&gt;</span>
 <span class="source-line-no">124</span><span id="line-124"> *</span>
 <span class="source-line-no">125</span><span id="line-125"> * &lt;p&gt;</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&lt;CSVRecord&gt; {</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&lt;String, Integer&gt; 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&lt;String&gt; headerNames;</span>
+<span class="source-line-no">202</span><span id="line-202">        final 
Map&lt;String, Integer&gt; 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&lt;String, Integer&gt; headerMap, final List&lt;String&gt; 
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">     * 
&lt;p&gt;</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">     * 
&lt;/p&gt;</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">     * 
&lt;p&gt;</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">     * 
&lt;/p&gt;</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">     * 
&lt;p&gt;</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">     * 
&lt;/p&gt;</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&lt;String&gt; 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&lt;String, Integer&gt; headerMap, final List&lt;String&gt; 
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">     * 
&lt;p&gt;</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">     * 
&lt;/p&gt;</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">     * 
&lt;p&gt;</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">     * 
&lt;/p&gt;</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">     * 
&lt;p&gt;</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">     * 
&lt;/p&gt;</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&lt;String&gt; recordList = new ArrayList&lt;&gt;();</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&lt;String&gt; recordList = new ArrayList&lt;&gt;();</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">     * 
&lt;p&gt;</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">     * 
&lt;/p&gt;</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">     * 
&lt;p&gt;</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">     * 
&lt;/p&gt;</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 &amp;&amp; input.isEmpty() &amp;&amp; 
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&lt;String, Integer&gt; 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&lt;&gt;(String.CASE_INSENSITIVE_ORDER) :</span>
-<span class="source-line-no">460</span><span id="line-460">                new 
LinkedHashMap&lt;&gt;();</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&lt;String, Integer&gt; hdrMap = null;</span>
-<span class="source-line-no">471</span><span id="line-471">        
List&lt;String&gt; 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 &lt; 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 &amp;&amp; !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 &amp;&amp; !duplicatesAllowed &amp;&amp; !(blankHeader 
&amp;&amp; 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&lt;&gt;(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">     * 
&lt;p&gt;</span>
-<span class="source-line-no">535</span><span id="line-535">     * 
&lt;strong&gt;ATTENTION:&lt;/strong&gt; 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">     * 
&lt;/p&gt;</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">     * 
&lt;p&gt;</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">     * 
&lt;/p&gt;</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">     * 
&lt;p&gt;</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">     * 
&lt;/p&gt;</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 &amp;&amp; input.isEmpty() &amp;&amp; 
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&lt;String, Integer&gt; 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&lt;&gt;(String.CASE_INSENSITIVE_ORDER) :</span>
+<span class="source-line-no">473</span><span id="line-473">                new 
LinkedHashMap&lt;&gt;();</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&lt;String, Integer&gt; hdrMap = null;</span>
+<span class="source-line-no">485</span><span id="line-485">        
List&lt;String&gt; 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 &lt; 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 &amp;&amp; !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 &amp;&amp; !duplicatesAllowed &amp;&amp; !(blankHeader 
&amp;&amp; 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&lt;&gt;(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 ...]


Reply via email to