Added: dev/commons/csv/1.7-RC1/site/jacoco/org.apache.commons.csv/CSVFormat.java.html ============================================================================== --- dev/commons/csv/1.7-RC1/site/jacoco/org.apache.commons.csv/CSVFormat.java.html (added) +++ dev/commons/csv/1.7-RC1/site/jacoco/org.apache.commons.csv/CSVFormat.java.html Sun Jun 2 00:19:07 2019 @@ -0,0 +1,2295 @@ +<?xml version="1.0" encoding="UTF-8"?><!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"><html xmlns="http://www.w3.org/1999/xhtml" lang="en"><head><meta http-equiv="Content-Type" content="text/html;charset=UTF-8"/><link rel="stylesheet" href="../jacoco-resources/report.css" type="text/css"/><link rel="shortcut icon" href="../jacoco-resources/report.gif" type="image/gif"/><title>CSVFormat.java</title><link rel="stylesheet" href="../jacoco-resources/prettify.css" type="text/css"/><script type="text/javascript" src="../jacoco-resources/prettify.js"></script></head><body onload="window['PR_TAB_WIDTH']=4;prettyPrint()"><div class="breadcrumb" id="breadcrumb"><span class="info"><a href="../jacoco-sessions.html" class="el_session">Sessions</a></span><a href="../index.html" class="el_report">Apache Commons CSV</a> > <a href="index.source.html" class="el_package">org.apache.commons.csv</a> > <span class="el_source">CSVFormat.ja va</span></div><h1>CSVFormat.java</h1><pre class="source lang-java linenums">/* + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed with + * this work for additional information regarding copyright ownership. + * The ASF licenses this file to You under the Apache License, Version 2.0 + * (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package org.apache.commons.csv; + +import static org.apache.commons.csv.Constants.BACKSLASH; +import static org.apache.commons.csv.Constants.COMMA; +import static org.apache.commons.csv.Constants.COMMENT; +import static org.apache.commons.csv.Constants.CR; +import static org.apache.commons.csv.Constants.CRLF; +import static org.apache.commons.csv.Constants.DOUBLE_QUOTE_CHAR; +import static org.apache.commons.csv.Constants.EMPTY; +import static org.apache.commons.csv.Constants.LF; +import static org.apache.commons.csv.Constants.PIPE; +import static org.apache.commons.csv.Constants.SP; +import static org.apache.commons.csv.Constants.TAB; + +import java.io.File; +import java.io.FileOutputStream; +import java.io.IOException; +import java.io.OutputStreamWriter; +import java.io.Reader; +import java.io.Serializable; +import java.io.StringWriter; +import java.io.Writer; +import java.nio.charset.Charset; +import java.nio.file.Files; +import java.nio.file.Path; +import java.sql.ResultSet; +import java.sql.ResultSetMetaData; +import java.sql.SQLException; +import java.util.Arrays; +import java.util.HashSet; +import java.util.Set; + +/** + * Specifies the format of a CSV file and parses input. + * + * <h2>Using predefined formats</h2> + * + * <p> + * You can use one of the predefined formats: + * </p> + * + * <ul> + * <li>{@link #DEFAULT}</li> + * <li>{@link #EXCEL}</li> + * <li>{@link #INFORMIX_UNLOAD}</li> + * <li>{@link #INFORMIX_UNLOAD_CSV}</li> + * <li>{@link #MYSQL}</li> + * <li>{@link #RFC4180}</li> + * <li>{@link #ORACLE}</li> + * <li>{@link #POSTGRESQL_CSV}</li> + * <li>{@link #POSTGRESQL_TEXT}</li> + * <li>{@link #TDF}</li> + * </ul> + * + * <p> + * For example: + * </p> + * + * <pre> + * CSVParser parser = CSVFormat.EXCEL.parse(reader); + * </pre> + * + * <p> + * The {@link CSVParser} provides static methods to parse other input types, for example: + * </p> + * + * <pre> + * CSVParser parser = CSVParser.parse(file, StandardCharsets.US_ASCII, CSVFormat.EXCEL); + * </pre> + * + * <h2>Defining formats</h2> + * + * <p> + * You can extend a format by calling the {@code with} methods. For example: + * </p> + * + * <pre> + * CSVFormat.EXCEL.withNullString(&quot;N/A&quot;).withIgnoreSurroundingSpaces(true); + * </pre> + * + * <h2>Defining column names</h2> + * + * <p> + * To define the column names you want to use to access records, write: + * </p> + * + * <pre> + * CSVFormat.EXCEL.withHeader(&quot;Col1&quot;, &quot;Col2&quot;, &quot;Col3&quot;); + * </pre> + * + * <p> + * Calling {@link #withHeader(String...)} let's you use the given names to address values in a {@link CSVRecord}, and + * assumes that your CSV source does not contain a first record that also defines column names. + * + * If it does, then you are overriding this metadata with your names and you should skip the first record by calling + * {@link #withSkipHeaderRecord(boolean)} with {@code true}. + * </p> + * + * <h2>Parsing</h2> + * + * <p> + * You can use a format directly to parse a reader. For example, to parse an Excel file with columns header, write: + * </p> + * + * <pre> + * Reader in = ...; + * CSVFormat.EXCEL.withHeader(&quot;Col1&quot;, &quot;Col2&quot;, &quot;Col3&quot;).parse(in); + * </pre> + * + * <p> + * For other input types, like resources, files, and URLs, use the static methods on {@link CSVParser}. + * </p> + * + * <h2>Referencing columns safely</h2> + * + * <p> + * If your source contains a header record, you can simplify your code and safely reference columns, by using + * {@link #withHeader(String...)} with no arguments: + * </p> + * + * <pre> + * CSVFormat.EXCEL.withHeader(); + * </pre> + * + * <p> + * This causes the parser to read the first record and use its values as column names. + * + * Then, call one of the {@link CSVRecord} get method that takes a String column name argument: + * </p> + * + * <pre> + * String value = record.get(&quot;Col1&quot;); + * </pre> + * + * <p> + * This makes your code impervious to changes in column order in the CSV file. + * </p> + * + * <h2>Notes</h2> + * + * <p> + * This class is immutable. + * </p> + */ +public final class CSVFormat implements Serializable { + + /** + * Predefines formats. + * + * @since 1.2 + */ +<span class="fc" id="L169"> public enum Predefined {</span> + + /** + * @see CSVFormat#DEFAULT + */ +<span class="fc" id="L174"> Default(CSVFormat.DEFAULT),</span> + + /** + * @see CSVFormat#EXCEL + */ +<span class="fc" id="L179"> Excel(CSVFormat.EXCEL),</span> + + /** + * @see CSVFormat#INFORMIX_UNLOAD + * @since 1.3 + */ +<span class="fc" id="L185"> InformixUnload(CSVFormat.INFORMIX_UNLOAD),</span> + + /** + * @see CSVFormat#INFORMIX_UNLOAD_CSV + * @since 1.3 + */ +<span class="fc" id="L191"> InformixUnloadCsv(CSVFormat.INFORMIX_UNLOAD_CSV),</span> + + /** + * @see CSVFormat#MONGODB_CSV + * @since 1.7 + */ +<span class="fc" id="L197"> MongoDBCsv(CSVFormat.MONGODB_CSV),</span> + + /** + * @see CSVFormat#MONGODB_TSV + * @since 1.7 + */ +<span class="fc" id="L203"> MongoDBTsv(CSVFormat.MONGODB_TSV),</span> + + /** + * @see CSVFormat#MYSQL + */ +<span class="fc" id="L208"> MySQL(CSVFormat.MYSQL),</span> + + /** + * @see CSVFormat#ORACLE + */ +<span class="fc" id="L213"> Oracle(CSVFormat.ORACLE),</span> + + /** + * @see CSVFormat#POSTGRESQL_CSV + * @since 1.5 + */ +<span class="fc" id="L219"> PostgreSQLCsv(CSVFormat.POSTGRESQL_CSV),</span> + + /** + * @see CSVFormat#POSTGRESQL_CSV + */ +<span class="fc" id="L224"> PostgreSQLText(CSVFormat.POSTGRESQL_TEXT),</span> + + /** + * @see CSVFormat#RFC4180 + */ +<span class="fc" id="L229"> RFC4180(CSVFormat.RFC4180),</span> + + /** + * @see CSVFormat#TDF + */ +<span class="fc" id="L234"> TDF(CSVFormat.TDF);</span> + + private final CSVFormat format; + +<span class="fc" id="L238"> Predefined(final CSVFormat format) {</span> +<span class="fc" id="L239"> this.format = format;</span> +<span class="fc" id="L240"> }</span> + + /** + * Gets the format. + * + * @return the format. + */ + public CSVFormat getFormat() { +<span class="fc" id="L248"> return format;</span> + } + } + + /** + * Standard Comma Separated Value format, as for {@link #RFC4180} but allowing empty lines. + * + * <p> + * Settings are: + * </p> + * <ul> + * <li>{@code withDelimiter(',')}</li> + * <li>{@code withQuote('"')}</li> + * <li>{@code withRecordSeparator("\r\n")}</li> + * <li>{@code withIgnoreEmptyLines(true)}</li> + * <li>{@code withAllowDuplicateHeaderNames(true)}</li> + * </ul> + * + * @see Predefined#Default + */ +<span class="fc" id="L268"> public static final CSVFormat DEFAULT = new CSVFormat(COMMA, DOUBLE_QUOTE_CHAR, null, null, null, false, true, CRLF,</span> + null, null, null, false, false, false, false, false, false, true); + + /** + * Excel file format (using a comma as the value delimiter). Note that the actual value delimiter used by Excel is + * locale dependent, it might be necessary to customize this format to accommodate to your regional settings. + * + * <p> + * For example for parsing or generating a CSV file on a French system the following format will be used: + * </p> + * + * <pre> + * CSVFormat fmt = CSVFormat.EXCEL.withDelimiter(';'); + * </pre> + * + * <p> + * Settings are: + * </p> + * <ul> + * <li>{@code {@link #withDelimiter(char) withDelimiter(',')}}</li> + * <li>{@code {@link #withQuote(char) withQuote('"')}}</li> + * <li>{@code {@link #withRecordSeparator(String) withRecordSeparator("\r\n")}}</li> + * <li>{@code {@link #withIgnoreEmptyLines(boolean) withIgnoreEmptyLines(false)}}</li> + * <li>{@code {@link #withAllowMissingColumnNames(boolean) withAllowMissingColumnNames(true)}}</li> + * <li>{@code {@link #withAllowDuplicateHeaderNames(boolean) withAllowDuplicateHeaderNames(true)}}</li> + * </ul> + * <p> + * Note: This is currently like {@link #RFC4180} plus {@link #withAllowMissingColumnNames(boolean) + * withAllowMissingColumnNames(true)} and {@link #withIgnoreEmptyLines(boolean) withIgnoreEmptyLines(false)}. + * </p> + * + * @see Predefined#Excel + */ + // @formatter:off +<span class="fc" id="L302"> public static final CSVFormat EXCEL = DEFAULT</span> +<span class="fc" id="L303"> .withIgnoreEmptyLines(false)</span> +<span class="fc" id="L304"> .withAllowMissingColumnNames();</span> + // @formatter:on + + /** + * Default Informix CSV UNLOAD format used by the {@code UNLOAD TO file_name} operation. + * + * <p> + * This is a comma-delimited format with a LF character as the line separator. Values are not quoted and special + * characters are escaped with {@code '\'}. The default NULL string is {@code "\\N"}. + * </p> + * + * <p> + * Settings are: + * </p> + * <ul> + * <li>{@code withDelimiter(',')}</li> + * <li>{@code withEscape('\\')}</li> + * <li>{@code withQuote("\"")}</li> + * <li>{@code withRecordSeparator('\n')}</li> + * </ul> + * + * @see Predefined#MySQL + * @see <a href= + * "http://www.ibm.com/support/knowledgecenter/SSBJG3_2.5.0/com.ibm.gen_busug.doc/c_fgl_InOutSql_UNLOAD.htm"> + * http://www.ibm.com/support/knowledgecenter/SSBJG3_2.5.0/com.ibm.gen_busug.doc/c_fgl_InOutSql_UNLOAD.htm</a> + * @since 1.3 + */ + // @formatter:off +<span class="fc" id="L332"> public static final CSVFormat INFORMIX_UNLOAD = DEFAULT</span> +<span class="fc" id="L333"> .withDelimiter(PIPE)</span> +<span class="fc" id="L334"> .withEscape(BACKSLASH)</span> +<span class="fc" id="L335"> .withQuote(DOUBLE_QUOTE_CHAR)</span> +<span class="fc" id="L336"> .withRecordSeparator(LF);</span> + // @formatter:on + + /** + * Default Informix CSV UNLOAD format used by the {@code UNLOAD TO file_name} operation (escaping is disabled.) + * + * <p> + * This is a comma-delimited format with a LF character as the line separator. Values are not quoted and special + * characters are escaped with {@code '\'}. The default NULL string is {@code "\\N"}. + * </p> + * + * <p> + * Settings are: + * </p> + * <ul> + * <li>{@code withDelimiter(',')}</li> + * <li>{@code withQuote("\"")}</li> + * <li>{@code withRecordSeparator('\n')}</li> + * </ul> + * + * @see Predefined#MySQL + * @see <a href= + * "http://www.ibm.com/support/knowledgecenter/SSBJG3_2.5.0/com.ibm.gen_busug.doc/c_fgl_InOutSql_UNLOAD.htm"> + * http://www.ibm.com/support/knowledgecenter/SSBJG3_2.5.0/com.ibm.gen_busug.doc/c_fgl_InOutSql_UNLOAD.htm</a> + * @since 1.3 + */ + // @formatter:off +<span class="fc" id="L363"> public static final CSVFormat INFORMIX_UNLOAD_CSV = DEFAULT</span> +<span class="fc" id="L364"> .withDelimiter(COMMA)</span> +<span class="fc" id="L365"> .withQuote(DOUBLE_QUOTE_CHAR)</span> +<span class="fc" id="L366"> .withRecordSeparator(LF);</span> + // @formatter:on + + /** + * Default MongoDB CSV format used by the {@code mongoexport} operation. + * <p> + * <b>Parsing is not supported yet.</b> + * </p> + * + * <p> + * This is a comma-delimited format. Values are double quoted only if needed and special characters are escaped with + * {@code '"'}. A header line with field names is expected. + * </p> + * + * <p> + * Settings are: + * </p> + * <ul> + * <li>{@code withDelimiter(',')}</li> + * <li>{@code withEscape('"')}</li> + * <li>{@code withQuote('"')}</li> + * <li>{@code withQuoteMode(QuoteMode.ALL_NON_NULL)}</li> + * <li>{@code withSkipHeaderRecord(false)}</li> + * </ul> + * + * @see Predefined#MongoDBCsv + * @see <a href="https://docs.mongodb.com/manual/reference/program/mongoexport/">MongoDB mongoexport command + * documentation</a> + * @since 1.7 + */ + // @formatter:off +<span class="fc" id="L397"> public static final CSVFormat MONGODB_CSV = DEFAULT</span> +<span class="fc" id="L398"> .withDelimiter(COMMA)</span> +<span class="fc" id="L399"> .withEscape(DOUBLE_QUOTE_CHAR)</span> +<span class="fc" id="L400"> .withQuote(DOUBLE_QUOTE_CHAR)</span> +<span class="fc" id="L401"> .withQuoteMode(QuoteMode.MINIMAL)</span> +<span class="fc" id="L402"> .withSkipHeaderRecord(false);</span> + // @formatter:off + + /** + * Default MongoDB TSV format used by the {@code mongoexport} operation. + * <p> + * <b>Parsing is not supported yet.</b> + * </p> + * + * <p> + * This is a tab-delimited format. Values are double quoted only if needed and special + * characters are escaped with {@code '"'}. A header line with field names is expected. + * </p> + * + * <p> + * Settings are: + * </p> + * <ul> + * <li>{@code withDelimiter('\t')}</li> + * <li>{@code withEscape('"')}</li> + * <li>{@code withQuote('"')}</li> + * <li>{@code withQuoteMode(QuoteMode.ALL_NON_NULL)}</li> + * <li>{@code withSkipHeaderRecord(false)}</li> + * </ul> + * + * @see Predefined#MongoDBCsv + * @see <a href="https://docs.mongodb.com/manual/reference/program/mongoexport/">MongoDB mongoexport command + * documentation</a> + * @since 1.7 + */ + // @formatter:off +<span class="fc" id="L433"> public static final CSVFormat MONGODB_TSV = DEFAULT</span> +<span class="fc" id="L434"> .withDelimiter(TAB)</span> +<span class="fc" id="L435"> .withEscape(DOUBLE_QUOTE_CHAR)</span> +<span class="fc" id="L436"> .withQuote(DOUBLE_QUOTE_CHAR)</span> +<span class="fc" id="L437"> .withQuoteMode(QuoteMode.MINIMAL)</span> +<span class="fc" id="L438"> .withSkipHeaderRecord(false);</span> + // @formatter:off + + /** + * Default MySQL format used by the {@code SELECT INTO OUTFILE} and {@code LOAD DATA INFILE} operations. + * + * <p> + * This is a tab-delimited format with a LF character as the line separator. Values are not quoted and special + * characters are escaped with {@code '\'}. The default NULL string is {@code "\\N"}. + * </p> + * + * <p> + * Settings are: + * </p> + * <ul> + * <li>{@code withDelimiter('\t')}</li> + * <li>{@code withEscape('\\')}</li> + * <li>{@code withIgnoreEmptyLines(false)}</li> + * <li>{@code withQuote(null)}</li> + * <li>{@code withRecordSeparator('\n')}</li> + * <li>{@code withNullString("\\N")}</li> + * <li>{@code withQuoteMode(QuoteMode.ALL_NON_NULL)}</li> + * </ul> + * + * @see Predefined#MySQL + * @see <a href="http://dev.mysql.com/doc/refman/5.1/en/load-data.html"> http://dev.mysql.com/doc/refman/5.1/en/load + * -data.html</a> + */ + // @formatter:off +<span class="fc" id="L467"> public static final CSVFormat MYSQL = DEFAULT</span> +<span class="fc" id="L468"> .withDelimiter(TAB)</span> +<span class="fc" id="L469"> .withEscape(BACKSLASH)</span> +<span class="fc" id="L470"> .withIgnoreEmptyLines(false)</span> +<span class="fc" id="L471"> .withQuote(null)</span> +<span class="fc" id="L472"> .withRecordSeparator(LF)</span> +<span class="fc" id="L473"> .withNullString("\\N")</span> +<span class="fc" id="L474"> .withQuoteMode(QuoteMode.ALL_NON_NULL);</span> + // @formatter:off + + /** + * Default Oracle format used by the SQL*Loader utility. + * + * <p> + * This is a comma-delimited format with the system line separator character as the record separator.Values are + * double quoted when needed and special characters are escaped with {@code '"'}. The default NULL string is + * {@code ""}. Values are trimmed. + * </p> + * + * <p> + * Settings are: + * </p> + * <ul> + * <li>{@code withDelimiter(',') // default is {@code FIELDS TERMINATED BY ','}}</li> + * <li>{@code withEscape('\\')}</li> + * <li>{@code withIgnoreEmptyLines(false)}</li> + * <li>{@code withQuote('"') // default is {@code OPTIONALLY ENCLOSED BY '"'}}</li> + * <li>{@code withNullString("\\N")}</li> + * <li>{@code withTrim()}</li> + * <li>{@code withSystemRecordSeparator()}</li> + * <li>{@code withQuoteMode(QuoteMode.MINIMAL)}</li> + * </ul> + * + * @see Predefined#Oracle + * @see <a href="https://s.apache.org/CGXG">Oracle CSV Format Specification</a> + * @since 1.6 + */ + // @formatter:off +<span class="fc" id="L505"> public static final CSVFormat ORACLE = DEFAULT</span> +<span class="fc" id="L506"> .withDelimiter(COMMA)</span> +<span class="fc" id="L507"> .withEscape(BACKSLASH)</span> +<span class="fc" id="L508"> .withIgnoreEmptyLines(false)</span> +<span class="fc" id="L509"> .withQuote(DOUBLE_QUOTE_CHAR)</span> +<span class="fc" id="L510"> .withNullString("\\N")</span> +<span class="fc" id="L511"> .withTrim()</span> +<span class="fc" id="L512"> .withSystemRecordSeparator()</span> +<span class="fc" id="L513"> .withQuoteMode(QuoteMode.MINIMAL);</span> + // @formatter:off + + /** + * Default PostgreSQL CSV format used by the {@code COPY} operation. + * + * <p> + * This is a comma-delimited format with a LF character as the line separator. Values are double quoted and special + * characters are escaped with {@code '"'}. The default NULL string is {@code ""}. + * </p> + * + * <p> + * Settings are: + * </p> + * <ul> + * <li>{@code withDelimiter(',')}</li> + * <li>{@code withEscape('"')}</li> + * <li>{@code withIgnoreEmptyLines(false)}</li> + * <li>{@code withQuote('"')}</li> + * <li>{@code withRecordSeparator('\n')}</li> + * <li>{@code withNullString("")}</li> + * <li>{@code withQuoteMode(QuoteMode.ALL_NON_NULL)}</li> + * </ul> + * + * @see Predefined#MySQL + * @see <a href="https://www.postgresql.org/docs/current/static/sql-copy.html">PostgreSQL COPY command + * documentation</a> + * @since 1.5 + */ + // @formatter:off +<span class="fc" id="L543"> public static final CSVFormat POSTGRESQL_CSV = DEFAULT</span> +<span class="fc" id="L544"> .withDelimiter(COMMA)</span> +<span class="fc" id="L545"> .withEscape(DOUBLE_QUOTE_CHAR)</span> +<span class="fc" id="L546"> .withIgnoreEmptyLines(false)</span> +<span class="fc" id="L547"> .withQuote(DOUBLE_QUOTE_CHAR)</span> +<span class="fc" id="L548"> .withRecordSeparator(LF)</span> +<span class="fc" id="L549"> .withNullString(EMPTY)</span> +<span class="fc" id="L550"> .withQuoteMode(QuoteMode.ALL_NON_NULL);</span> + // @formatter:off + + /** + * Default PostgreSQL text format used by the {@code COPY} operation. + * + * <p> + * This is a tab-delimited format with a LF character as the line separator. Values are double quoted and special + * characters are escaped with {@code '"'}. The default NULL string is {@code "\\N"}. + * </p> + * + * <p> + * Settings are: + * </p> + * <ul> + * <li>{@code withDelimiter('\t')}</li> + * <li>{@code withEscape('\\')}</li> + * <li>{@code withIgnoreEmptyLines(false)}</li> + * <li>{@code withQuote('"')}</li> + * <li>{@code withRecordSeparator('\n')}</li> + * <li>{@code withNullString("\\N")}</li> + * <li>{@code withQuoteMode(QuoteMode.ALL_NON_NULL)}</li> + * </ul> + * + * @see Predefined#MySQL + * @see <a href="https://www.postgresql.org/docs/current/static/sql-copy.html">PostgreSQL COPY command + * documentation</a> + * @since 1.5 + */ + // @formatter:off +<span class="fc" id="L580"> public static final CSVFormat POSTGRESQL_TEXT = DEFAULT</span> +<span class="fc" id="L581"> .withDelimiter(TAB)</span> +<span class="fc" id="L582"> .withEscape(BACKSLASH)</span> +<span class="fc" id="L583"> .withIgnoreEmptyLines(false)</span> +<span class="fc" id="L584"> .withQuote(DOUBLE_QUOTE_CHAR)</span> +<span class="fc" id="L585"> .withRecordSeparator(LF)</span> +<span class="fc" id="L586"> .withNullString("\\N")</span> +<span class="fc" id="L587"> .withQuoteMode(QuoteMode.ALL_NON_NULL);</span> + // @formatter:off + + /** + * Comma separated format as defined by <a href="http://tools.ietf.org/html/rfc4180">RFC 4180</a>. + * + * <p> + * Settings are: + * </p> + * <ul> + * <li>{@code withDelimiter(',')}</li> + * <li>{@code withQuote('"')}</li> + * <li>{@code withRecordSeparator("\r\n")}</li> + * <li>{@code withIgnoreEmptyLines(false)}</li> + * </ul> + * + * @see Predefined#RFC4180 + */ +<span class="fc" id="L605"> public static final CSVFormat RFC4180 = DEFAULT.withIgnoreEmptyLines(false);</span> + + private static final long serialVersionUID = 1L; + + /** + * Tab-delimited format. + * + * <p> + * Settings are: + * </p> + * <ul> + * <li>{@code withDelimiter('\t')}</li> + * <li>{@code withQuote('"')}</li> + * <li>{@code withRecordSeparator("\r\n")}</li> + * <li>{@code withIgnoreSurroundingSpaces(true)}</li> + * </ul> + * + * @see Predefined#TDF + */ + // @formatter:off +<span class="fc" id="L625"> public static final CSVFormat TDF = DEFAULT</span> +<span class="fc" id="L626"> .withDelimiter(TAB)</span> +<span class="fc" id="L627"> .withIgnoreSurroundingSpaces();</span> + // @formatter:on + + /** + * Returns true if the given character is a line break character. + * + * @param c + * the character to check + * + * @return true if <code>c</code> is a line break character + */ + private static boolean isLineBreak(final char c) { +<span class="fc bfc" id="L639" title="All 4 branches covered."> return c == LF || c == CR;</span> + } + + /** + * Returns true if the given character is a line break character. + * + * @param c + * the character to check, may be null + * + * @return true if <code>c</code> is a line break character (and not null) + */ + private static boolean isLineBreak(final Character c) { +<span class="fc bfc" id="L651" title="All 4 branches covered."> return c != null && isLineBreak(c.charValue());</span> + } + + /** + * Creates a new CSV format with the specified delimiter. + * + * <p> + * Use this method if you want to create a CSVFormat from scratch. All fields but the delimiter will be initialized + * with null/false. + * </p> + * + * @param delimiter + * the char used for value separation, must not be a line break character + * @return a new CSV format. + * @throws IllegalArgumentException + * if the delimiter is a line break character + * + * @see #DEFAULT + * @see #RFC4180 + * @see #MYSQL + * @see #EXCEL + * @see #TDF + */ + public static CSVFormat newFormat(final char delimiter) { +<span class="fc" id="L675"> return new CSVFormat(delimiter, null, null, null, null, false, false, null, null, null, null, false, false,</span> + false, false, false, false, true); + } + + /** + * Gets one of the predefined formats from {@link CSVFormat.Predefined}. + * + * @param format + * name + * @return one of the predefined formats + * @since 1.2 + */ + public static CSVFormat valueOf(final String format) { +<span class="fc" id="L688"> return CSVFormat.Predefined.valueOf(format).getFormat();</span> + } + + private final boolean allowDuplicateHeaderNames; + + private final boolean allowMissingColumnNames; + + private final boolean autoFlush; + + private final Character commentMarker; // null if commenting is disabled + + private final char delimiter; + + private final Character escapeCharacter; // null if escaping is disabled + + private final String[] header; // array of header column names + + private final String[] headerComments; // array of header comment lines + + private final boolean ignoreEmptyLines; + + private final boolean ignoreHeaderCase; // should ignore header names case + + private final boolean ignoreSurroundingSpaces; // Should leading/trailing spaces be ignored around values? + + private final String nullString; // the string to be used for null values + + private final Character quoteCharacter; // null if quoting is disabled + + private final String quotedNullString; + + private final QuoteMode quoteMode; + + private final String recordSeparator; // for outputs + + private final boolean skipHeaderRecord; + + private final boolean trailingDelimiter; + + private final boolean trim; + + /** + * Creates a customized CSV format. + * + * @param delimiter + * the char used for value separation, must not be a line break character + * @param quoteChar + * the Character used as value encapsulation marker, may be {@code null} to disable + * @param quoteMode + * the quote mode + * @param commentStart + * the Character used for comment identification, may be {@code null} to disable + * @param escape + * the Character used to escape special characters in values, may be {@code null} to disable + * @param ignoreSurroundingSpaces + * {@code true} when whitespaces enclosing values should be ignored + * @param ignoreEmptyLines + * {@code true} when the parser should skip empty lines + * @param recordSeparator + * the line separator to use for output + * @param nullString + * the line separator to use for output + * @param headerComments + * the comments to be printed by the Printer before the actual CSV data + * @param header + * the header + * @param skipHeaderRecord + * TODO + * @param allowMissingColumnNames + * TODO + * @param ignoreHeaderCase + * TODO + * @param trim + * TODO + * @param trailingDelimiter + * TODO + * @param autoFlush + * @throws IllegalArgumentException + * if the delimiter is a line break character + */ + private CSVFormat(final char delimiter, final Character quoteChar, final QuoteMode quoteMode, + final Character commentStart, final Character escape, final boolean ignoreSurroundingSpaces, + final boolean ignoreEmptyLines, final String recordSeparator, final String nullString, + final Object[] headerComments, final String[] header, final boolean skipHeaderRecord, + final boolean allowMissingColumnNames, final boolean ignoreHeaderCase, final boolean trim, +<span class="fc" id="L773"> final boolean trailingDelimiter, final boolean autoFlush, final boolean allowDuplicateHeaderNames) {</span> +<span class="fc" id="L774"> this.delimiter = delimiter;</span> +<span class="fc" id="L775"> this.quoteCharacter = quoteChar;</span> +<span class="fc" id="L776"> this.quoteMode = quoteMode;</span> +<span class="fc" id="L777"> this.commentMarker = commentStart;</span> +<span class="fc" id="L778"> this.escapeCharacter = escape;</span> +<span class="fc" id="L779"> this.ignoreSurroundingSpaces = ignoreSurroundingSpaces;</span> +<span class="fc" id="L780"> this.allowMissingColumnNames = allowMissingColumnNames;</span> +<span class="fc" id="L781"> this.ignoreEmptyLines = ignoreEmptyLines;</span> +<span class="fc" id="L782"> this.recordSeparator = recordSeparator;</span> +<span class="fc" id="L783"> this.nullString = nullString;</span> +<span class="fc" id="L784"> this.headerComments = toStringArray(headerComments);</span> +<span class="fc bfc" id="L785" title="All 2 branches covered."> this.header = header == null ? null : header.clone();</span> +<span class="fc" id="L786"> this.skipHeaderRecord = skipHeaderRecord;</span> +<span class="fc" id="L787"> this.ignoreHeaderCase = ignoreHeaderCase;</span> +<span class="fc" id="L788"> this.trailingDelimiter = trailingDelimiter;</span> +<span class="fc" id="L789"> this.trim = trim;</span> +<span class="fc" id="L790"> this.autoFlush = autoFlush;</span> +<span class="fc" id="L791"> this.quotedNullString = quoteCharacter + nullString + quoteCharacter;</span> +<span class="fc" id="L792"> this.allowDuplicateHeaderNames = allowDuplicateHeaderNames;</span> +<span class="fc" id="L793"> validate();</span> +<span class="fc" id="L794"> }</span> + + @Override + public boolean equals(final Object obj) { +<span class="fc bfc" id="L798" title="All 2 branches covered."> if (this == obj) {</span> +<span class="fc" id="L799"> return true;</span> + } +<span class="fc bfc" id="L801" title="All 2 branches covered."> if (obj == null) {</span> +<span class="fc" id="L802"> return false;</span> + } +<span class="fc bfc" id="L804" title="All 2 branches covered."> if (getClass() != obj.getClass()) {</span> +<span class="fc" id="L805"> return false;</span> + } + +<span class="fc" id="L808"> final CSVFormat other = (CSVFormat) obj;</span> +<span class="fc bfc" id="L809" title="All 2 branches covered."> if (delimiter != other.delimiter) {</span> +<span class="fc" id="L810"> return false;</span> + } +<span class="fc bfc" id="L812" title="All 2 branches covered."> if (quoteMode != other.quoteMode) {</span> +<span class="fc" id="L813"> return false;</span> + } +<span class="fc bfc" id="L815" title="All 2 branches covered."> if (quoteCharacter == null) {</span> +<span class="fc bfc" id="L816" title="All 2 branches covered."> if (other.quoteCharacter != null) {</span> +<span class="fc" id="L817"> return false;</span> + } +<span class="fc bfc" id="L819" title="All 2 branches covered."> } else if (!quoteCharacter.equals(other.quoteCharacter)) {</span> +<span class="fc" id="L820"> return false;</span> + } +<span class="fc bfc" id="L822" title="All 2 branches covered."> if (commentMarker == null) {</span> +<span class="fc bfc" id="L823" title="All 2 branches covered."> if (other.commentMarker != null) {</span> +<span class="fc" id="L824"> return false;</span> + } +<span class="fc bfc" id="L826" title="All 2 branches covered."> } else if (!commentMarker.equals(other.commentMarker)) {</span> +<span class="fc" id="L827"> return false;</span> + } +<span class="fc bfc" id="L829" title="All 2 branches covered."> if (escapeCharacter == null) {</span> +<span class="pc bpc" id="L830" title="1 of 2 branches missed."> if (other.escapeCharacter != null) {</span> +<span class="nc" id="L831"> return false;</span> + } +<span class="fc bfc" id="L833" title="All 2 branches covered."> } else if (!escapeCharacter.equals(other.escapeCharacter)) {</span> +<span class="fc" id="L834"> return false;</span> + } +<span class="fc bfc" id="L836" title="All 2 branches covered."> if (nullString == null) {</span> +<span class="pc bpc" id="L837" title="1 of 2 branches missed."> if (other.nullString != null) {</span> +<span class="nc" id="L838"> return false;</span> + } +<span class="fc bfc" id="L840" title="All 2 branches covered."> } else if (!nullString.equals(other.nullString)) {</span> +<span class="fc" id="L841"> return false;</span> + } +<span class="fc bfc" id="L843" title="All 2 branches covered."> if (!Arrays.equals(header, other.header)) {</span> +<span class="fc" id="L844"> return false;</span> + } +<span class="fc bfc" id="L846" title="All 2 branches covered."> if (ignoreSurroundingSpaces != other.ignoreSurroundingSpaces) {</span> +<span class="fc" id="L847"> return false;</span> + } +<span class="fc bfc" id="L849" title="All 2 branches covered."> if (ignoreEmptyLines != other.ignoreEmptyLines) {</span> +<span class="fc" id="L850"> return false;</span> + } +<span class="fc bfc" id="L852" title="All 2 branches covered."> if (skipHeaderRecord != other.skipHeaderRecord) {</span> +<span class="fc" id="L853"> return false;</span> + } +<span class="fc bfc" id="L855" title="All 2 branches covered."> if (recordSeparator == null) {</span> +<span class="pc bpc" id="L856" title="1 of 2 branches missed."> if (other.recordSeparator != null) {</span> +<span class="nc" id="L857"> return false;</span> + } +<span class="fc bfc" id="L859" title="All 2 branches covered."> } else if (!recordSeparator.equals(other.recordSeparator)) {</span> +<span class="fc" id="L860"> return false;</span> + } +<span class="fc" id="L862"> return true;</span> + } + + /** + * Formats the specified values. + * + * @param values + * the values to format + * @return the formatted values + */ + public String format(final Object... values) { +<span class="fc" id="L873"> final StringWriter out = new StringWriter();</span> +<span class="fc" id="L874"> try (final CSVPrinter csvPrinter = new CSVPrinter(out, this)) {</span> +<span class="fc" id="L875"> csvPrinter.printRecord(values);</span> +<span class="fc" id="L876"> return out.toString().trim();</span> +<span class="nc" id="L877"> } catch (final IOException e) {</span> + // should not happen because a StringWriter does not do IO. +<span class="nc" id="L879"> throw new IllegalStateException(e);</span> + } + } + + /** + * Returns true if and only if duplicate names are allowed in the headers. + * + * @return whether duplicate header names are allowed + * @since 1.7 + */ + public boolean getAllowDuplicateHeaderNames() { +<span class="fc" id="L890"> return allowDuplicateHeaderNames;</span> + } + + /** + * Specifies whether missing column names are allowed when parsing the header line. + * + * @return {@code true} if missing column names are allowed when parsing the header line, {@code false} to throw an + * {@link IllegalArgumentException}. + */ + public boolean getAllowMissingColumnNames() { +<span class="fc" id="L900"> return allowMissingColumnNames;</span> + } + + /** + * Returns whether to flush on close. + * + * @return whether to flush on close. + * @since 1.6 + */ + public boolean getAutoFlush() { +<span class="fc" id="L910"> return autoFlush;</span> + } + + /** + * Returns the character marking the start of a line comment. + * + * @return the comment start marker, may be {@code null} + */ + public Character getCommentMarker() { +<span class="fc" id="L919"> return commentMarker;</span> + } + + /** + * Returns the character delimiting the values (typically ';', ',' or '\t'). + * + * @return the delimiter character + */ + public char getDelimiter() { +<span class="fc" id="L928"> return delimiter;</span> + } + + /** + * Returns the escape character. + * + * @return the escape character, may be {@code null} + */ + public Character getEscapeCharacter() { +<span class="fc" id="L937"> return escapeCharacter;</span> + } + + /** + * Returns a copy of the header array. + * + * @return a copy of the header array; {@code null} if disabled, the empty array if to be read from the file + */ + public String[] getHeader() { +<span class="fc bfc" id="L946" title="All 2 branches covered."> return header != null ? header.clone() : null;</span> + } + + /** + * Returns a copy of the header comment array. + * + * @return a copy of the header comment array; {@code null} if disabled. + */ + public String[] getHeaderComments() { +<span class="fc bfc" id="L955" title="All 2 branches covered."> return headerComments != null ? headerComments.clone() : null;</span> + } + + /** + * Specifies whether empty lines between records are ignored when parsing input. + * + * @return {@code true} if empty lines between records are ignored, {@code false} if they are turned into empty + * records. + */ + public boolean getIgnoreEmptyLines() { +<span class="fc" id="L965"> return ignoreEmptyLines;</span> + } + + /** + * Specifies whether header names will be accessed ignoring case. + * + * @return {@code true} if header names cases are ignored, {@code false} if they are case sensitive. + * @since 1.3 + */ + public boolean getIgnoreHeaderCase() { +<span class="fc" id="L975"> return ignoreHeaderCase;</span> + } + + /** + * Specifies whether spaces around values are ignored when parsing input. + * + * @return {@code true} if spaces around values are ignored, {@code false} if they are treated as part of the value. + */ + public boolean getIgnoreSurroundingSpaces() { +<span class="fc" id="L984"> return ignoreSurroundingSpaces;</span> + } + + /** + * Gets the String to convert to and from {@code null}. + * <ul> + * <li><strong>Reading:</strong> Converts strings equal to the given {@code nullString} to {@code null} when reading + * records.</li> + * <li><strong>Writing:</strong> Writes {@code null} as the given {@code nullString} when writing records.</li> + * </ul> + * + * @return the String to convert to and from {@code null}. No substitution occurs if {@code null} + */ + public String getNullString() { +<span class="fc" id="L998"> return nullString;</span> + } + + /** + * Returns the character used to encapsulate values containing special characters. + * + * @return the quoteChar character, may be {@code null} + */ + public Character getQuoteCharacter() { +<span class="fc" id="L1007"> return quoteCharacter;</span> + } + + /** + * Returns the quote policy output fields. + * + * @return the quote policy + */ + public QuoteMode getQuoteMode() { +<span class="fc" id="L1016"> return quoteMode;</span> + } + + /** + * Returns the record separator delimiting output records. + * + * @return the record separator + */ + public String getRecordSeparator() { +<span class="fc" id="L1025"> return recordSeparator;</span> + } + + /** + * Returns whether to skip the header record. + * + * @return whether to skip the header record. + */ + public boolean getSkipHeaderRecord() { +<span class="fc" id="L1034"> return skipHeaderRecord;</span> + } + + /** + * Returns whether to add a trailing delimiter. + * + * @return whether to add a trailing delimiter. + * @since 1.3 + */ + public boolean getTrailingDelimiter() { +<span class="fc" id="L1044"> return trailingDelimiter;</span> + } + + /** + * Returns whether to trim leading and trailing blanks. + * + * @return whether to trim leading and trailing blanks. + */ + public boolean getTrim() { +<span class="fc" id="L1053"> return trim;</span> + } + + @Override + public int hashCode() { +<span class="fc" id="L1058"> final int prime = 31;</span> +<span class="fc" id="L1059"> int result = 1;</span> + +<span class="fc" id="L1061"> result = prime * result + delimiter;</span> +<span class="pc bpc" id="L1062" title="1 of 2 branches missed."> result = prime * result + ((quoteMode == null) ? 0 : quoteMode.hashCode());</span> +<span class="pc bpc" id="L1063" title="1 of 2 branches missed."> result = prime * result + ((quoteCharacter == null) ? 0 : quoteCharacter.hashCode());</span> +<span class="pc bpc" id="L1064" title="1 of 2 branches missed."> result = prime * result + ((commentMarker == null) ? 0 : commentMarker.hashCode());</span> +<span class="pc bpc" id="L1065" title="1 of 2 branches missed."> result = prime * result + ((escapeCharacter == null) ? 0 : escapeCharacter.hashCode());</span> +<span class="pc bpc" id="L1066" title="1 of 2 branches missed."> result = prime * result + ((nullString == null) ? 0 : nullString.hashCode());</span> +<span class="pc bpc" id="L1067" title="1 of 2 branches missed."> result = prime * result + (ignoreSurroundingSpaces ? 1231 : 1237);</span> +<span class="fc bfc" id="L1068" title="All 2 branches covered."> result = prime * result + (ignoreHeaderCase ? 1231 : 1237);</span> +<span class="pc bpc" id="L1069" title="1 of 2 branches missed."> result = prime * result + (ignoreEmptyLines ? 1231 : 1237);</span> +<span class="pc bpc" id="L1070" title="1 of 2 branches missed."> result = prime * result + (skipHeaderRecord ? 1231 : 1237);</span> +<span class="pc bpc" id="L1071" title="1 of 2 branches missed."> result = prime * result + ((recordSeparator == null) ? 0 : recordSeparator.hashCode());</span> +<span class="fc" id="L1072"> result = prime * result + Arrays.hashCode(header);</span> +<span class="fc" id="L1073"> return result;</span> + } + + /** + * Specifies whether comments are supported by this format. + * + * Note that the comment introducer character is only recognized at the start of a line. + * + * @return {@code true} is comments are supported, {@code false} otherwise + */ + public boolean isCommentMarkerSet() { +<span class="fc bfc" id="L1084" title="All 2 branches covered."> return commentMarker != null;</span> + } + + /** + * Returns whether escape are being processed. + * + * @return {@code true} if escapes are processed + */ + public boolean isEscapeCharacterSet() { +<span class="fc bfc" id="L1093" title="All 2 branches covered."> return escapeCharacter != null;</span> + } + + /** + * Returns whether a nullString has been defined. + * + * @return {@code true} if a nullString is defined + */ + public boolean isNullStringSet() { +<span class="fc bfc" id="L1102" title="All 2 branches covered."> return nullString != null;</span> + } + + /** + * Returns whether a quoteChar has been defined. + * + * @return {@code true} if a quoteChar is defined + */ + public boolean isQuoteCharacterSet() { +<span class="fc bfc" id="L1111" title="All 2 branches covered."> return quoteCharacter != null;</span> + } + + /** + * Parses the specified content. + * + * <p> + * See also the various static parse methods on {@link CSVParser}. + * </p> + * + * @param in + * the input stream + * @return a parser over a stream of {@link CSVRecord}s. + * @throws IOException + * If an I/O error occurs + */ + public CSVParser parse(final Reader in) throws IOException { +<span class="fc" id="L1128"> return new CSVParser(in, this);</span> + } + + /** + * Prints to the specified output. + * + * <p> + * See also {@link CSVPrinter}. + * </p> + * + * @param out + * the output. + * @return a printer to an output. + * @throws IOException + * thrown if the optional header cannot be printed. + */ + public CSVPrinter print(final Appendable out) throws IOException { +<span class="fc" id="L1145"> return new CSVPrinter(out, this);</span> + } + + /** + * Prints to the specified output. + * + * <p> + * See also {@link CSVPrinter}. + * </p> + * + * @param out + * the output. + * @param charset + * A charset. + * @return a printer to an output. + * @throws IOException + * thrown if the optional header cannot be printed. + * @since 1.5 + */ + @SuppressWarnings("resource") + public CSVPrinter print(final File out, final Charset charset) throws IOException { + // The writer will be closed when close() is called. +<span class="fc" id="L1167"> return new CSVPrinter(new OutputStreamWriter(new FileOutputStream(out), charset), this);</span> + } + + /** + * Prints the {@code value} as the next value on the line to {@code out}. The value will be escaped or encapsulated + * as needed. Useful when one wants to avoid creating CSVPrinters. + * + * @param value + * value to output. + * @param out + * where to print the value. + * @param newRecord + * if this a new record. + * @throws IOException + * If an I/O error occurs. + * @since 1.4 + */ + public void print(final Object value, final Appendable out, final boolean newRecord) throws IOException { + // null values are considered empty + // Only call CharSequence.toString() if you have to, helps GC-free use cases. + CharSequence charSequence; +<span class="fc bfc" id="L1188" title="All 2 branches covered."> if (value == null) {</span> + // https://issues.apache.org/jira/browse/CSV-203 +<span class="fc bfc" id="L1190" title="All 2 branches covered."> if (null == nullString) {</span> +<span class="fc" id="L1191"> charSequence = EMPTY;</span> + } else { +<span class="fc bfc" id="L1193" title="All 2 branches covered."> if (QuoteMode.ALL == quoteMode) {</span> +<span class="fc" id="L1194"> charSequence = quotedNullString;</span> + } else { +<span class="fc" id="L1196"> charSequence = nullString;</span> + } + } + } else { +<span class="fc bfc" id="L1200" title="All 2 branches covered."> if (value instanceof CharSequence) {</span> +<span class="fc" id="L1201"> charSequence = (CharSequence) value;</span> +<span class="fc bfc" id="L1202" title="All 2 branches covered."> } else if (value instanceof Reader) {</span> +<span class="fc" id="L1203"> print((Reader) value, out, newRecord);</span> +<span class="fc" id="L1204"> return;</span> + } else { +<span class="fc" id="L1206"> charSequence = value.toString();</span> + } + } +<span class="fc bfc" id="L1209" title="All 2 branches covered."> charSequence = getTrim() ? trim(charSequence) : charSequence;</span> +<span class="fc" id="L1210"> print(value, charSequence, out, newRecord);</span> +<span class="fc" id="L1211"> }</span> + + private void print(final Object object, final CharSequence value, final Appendable out, final boolean newRecord) + throws IOException { +<span class="fc" id="L1215"> final int offset = 0;</span> +<span class="fc" id="L1216"> final int len = value.length();</span> +<span class="fc bfc" id="L1217" title="All 2 branches covered."> if (!newRecord) {</span> +<span class="fc" id="L1218"> out.append(getDelimiter());</span> + } +<span class="fc bfc" id="L1220" title="All 2 branches covered."> if (object == null) {</span> +<span class="fc" id="L1221"> out.append(value);</span> +<span class="fc bfc" id="L1222" title="All 2 branches covered."> } else if (isQuoteCharacterSet()) {</span> + // the original object is needed so can check for Number +<span class="fc" id="L1224"> printWithQuotes(object, value, out, newRecord);</span> +<span class="fc bfc" id="L1225" title="All 2 branches covered."> } else if (isEscapeCharacterSet()) {</span> +<span class="fc" id="L1226"> printWithEscapes(value, out);</span> + } else { +<span class="fc" id="L1228"> out.append(value, offset, len);</span> + } +<span class="fc" id="L1230"> }</span> + + /** + * Prints to the specified output. + * + * <p> + * See also {@link CSVPrinter}. + * </p> + * + * @param out + * the output. + * @param charset + * A charset. + * @return a printer to an output. + * @throws IOException + * thrown if the optional header cannot be printed. + * @since 1.5 + */ + public CSVPrinter print(final Path out, final Charset charset) throws IOException { +<span class="fc" id="L1249"> return print(Files.newBufferedWriter(out, charset));</span> + } + + private void print(final Reader reader, final Appendable out, final boolean newRecord) throws IOException { + // Reader is never null +<span class="pc bpc" id="L1254" title="1 of 2 branches missed."> if (!newRecord) {</span> +<span class="fc" id="L1255"> out.append(getDelimiter());</span> + } +<span class="pc bpc" id="L1257" title="1 of 2 branches missed."> if (isQuoteCharacterSet()) {</span> +<span class="fc" id="L1258"> printWithQuotes(reader, out);</span> +<span class="nc bnc" id="L1259" title="All 2 branches missed."> } else if (isEscapeCharacterSet()) {</span> +<span class="nc" id="L1260"> printWithEscapes(reader, out);</span> +<span class="nc bnc" id="L1261" title="All 2 branches missed."> } else if (out instanceof Writer) {</span> +<span class="nc" id="L1262"> IOUtils.copyLarge(reader, (Writer) out);</span> + } else { +<span class="nc" id="L1264"> IOUtils.copy(reader, out);</span> + } + +<span class="fc" id="L1267"> }</span> + + /** + * Prints to the {@link System#out}. + * + * <p> + * See also {@link CSVPrinter}. + * </p> + * + * @return a printer to {@link System#out}. + * @throws IOException + * thrown if the optional header cannot be printed. + * @since 1.5 + */ + public CSVPrinter printer() throws IOException { +<span class="fc" id="L1282"> return new CSVPrinter(System.out, this);</span> + } + + /** + * Outputs the trailing delimiter (if set) followed by the record separator (if set). + * + * @param out + * where to write + * @throws IOException + * If an I/O error occurs + * @since 1.4 + */ + public void println(final Appendable out) throws IOException { +<span class="fc bfc" id="L1295" title="All 2 branches covered."> if (getTrailingDelimiter()) {</span> +<span class="fc" id="L1296"> out.append(getDelimiter());</span> + } +<span class="fc bfc" id="L1298" title="All 2 branches covered."> if (recordSeparator != null) {</span> +<span class="fc" id="L1299"> out.append(recordSeparator);</span> + } +<span class="fc" id="L1301"> }</span> + + /** + * Prints the given {@code values} to {@code out} as a single record of delimiter separated values followed by the + * record separator. + * + * <p> + * The values will be quoted if needed. Quotes and new-line characters will be escaped. This method adds the record + * separator to the output after printing the record, so there is no need to call {@link #println(Appendable)}. + * </p> + * + * @param out + * where to write. + * @param values + * values to output. + * @throws IOException + * If an I/O error occurs. + * @since 1.4 + */ + public void printRecord(final Appendable out, final Object... values) throws IOException { +<span class="fc bfc" id="L1321" title="All 2 branches covered."> for (int i = 0; i < values.length; i++) {</span> +<span class="fc bfc" id="L1322" title="All 2 branches covered."> print(values[i], out, i == 0);</span> + } +<span class="fc" id="L1324"> println(out);</span> +<span class="fc" id="L1325"> }</span> + + /* + * Note: must only be called if escaping is enabled, otherwise will generate NPE + */ + private void printWithEscapes(final CharSequence value, final Appendable out) throws IOException { +<span class="fc" id="L1331"> int start = 0;</span> +<span class="fc" id="L1332"> int pos = 0;</span> +<span class="fc" id="L1333"> final int len = value.length();</span> +<span class="fc" id="L1334"> final int end = len;</span> + +<span class="fc" id="L1336"> final char delim = getDelimiter();</span> +<span class="fc" id="L1337"> final char escape = getEscapeCharacter().charValue();</span> + +<span class="fc bfc" id="L1339" title="All 2 branches covered."> while (pos < end) {</span> +<span class="fc" id="L1340"> char c = value.charAt(pos);</span> +<span class="fc bfc" id="L1341" title="All 8 branches covered."> if (c == CR || c == LF || c == delim || c == escape) {</span> + // write out segment up until this char +<span class="fc bfc" id="L1343" title="All 2 branches covered."> if (pos > start) {</span> +<span class="fc" id="L1344"> out.append(value, start, pos);</span> + } +<span class="fc bfc" id="L1346" title="All 2 branches covered."> if (c == LF) {</span> +<span class="fc" id="L1347"> c = 'n';</span> +<span class="fc bfc" id="L1348" title="All 2 branches covered."> } else if (c == CR) {</span> +<span class="fc" id="L1349"> c = 'r';</span> + } + +<span class="fc" id="L1352"> out.append(escape);</span> +<span class="fc" id="L1353"> out.append(c);</span> + +<span class="fc" id="L1355"> start = pos + 1; // start on the current char after this one</span> + } +<span class="fc" id="L1357"> pos++;</span> +<span class="fc" id="L1358"> }</span> + + // write last segment +<span class="fc bfc" id="L1361" title="All 2 branches covered."> if (pos > start) {</span> +<span class="fc" id="L1362"> out.append(value, start, pos);</span> + } +<span class="fc" id="L1364"> }</span> + + private void printWithEscapes(final Reader reader, final Appendable out) throws IOException { +<span class="nc" id="L1367"> int start = 0;</span> +<span class="nc" id="L1368"> int pos = 0;</span> + +<span class="nc" id="L1370"> final char delim = getDelimiter();</span> +<span class="nc" id="L1371"> final char escape = getEscapeCharacter().charValue();</span> +<span class="nc" id="L1372"> final StringBuilder builder = new StringBuilder(IOUtils.DEFAULT_BUFFER_SIZE);</span> + + int c; +<span class="nc bnc" id="L1375" title="All 2 branches missed."> while (-1 != (c = reader.read())) {</span> +<span class="nc" id="L1376"> builder.append((char) c);</span> +<span class="nc bnc" id="L1377" title="All 8 branches missed."> if (c == CR || c == LF || c == delim || c == escape) {</span> + // write out segment up until this char +<span class="nc bnc" id="L1379" title="All 2 branches missed."> if (pos > start) {</span> +<span class="nc" id="L1380"> out.append(builder.substring(start, pos));</span> +<span class="nc" id="L1381"> builder.setLength(0);</span> + } +<span class="nc bnc" id="L1383" title="All 2 branches missed."> if (c == LF) {</span> +<span class="nc" id="L1384"> c = 'n';</span> +<span class="nc bnc" id="L1385" title="All 2 branches missed."> } else if (c == CR) {</span> +<span class="nc" id="L1386"> c = 'r';</span> + } + +<span class="nc" id="L1389"> out.append(escape);</span> +<span class="nc" id="L1390"> out.append((char) c);</span> + +<span class="nc" id="L1392"> start = pos + 1; // start on the current char after this one</span> + } +<span class="nc" id="L1394"> pos++;</span> + } + + // write last segment +<span class="nc bnc" id="L1398" title="All 2 branches missed."> if (pos > start) {</span> +<span class="nc" id="L1399"> out.append(builder.substring(start, pos));</span> + } +<span class="nc" id="L1401"> }</span> + + /* + * Note: must only be called if quoting is enabled, otherwise will generate NPE + */ + // the original object is needed so can check for Number + private void printWithQuotes(final Object object, final CharSequence value, final Appendable out, + final boolean newRecord) throws IOException { +<span class="fc" id="L1409"> boolean quote = false;</span> +<span class="fc" id="L1410"> int start = 0;</span> +<span class="fc" id="L1411"> int pos = 0;</span> +<span class="fc" id="L1412"> final int len = value.length();</span> +<span class="fc" id="L1413"> final int end = len;</span> + +<span class="fc" id="L1415"> final char delimChar = getDelimiter();</span> +<span class="fc" id="L1416"> final char quoteChar = getQuoteCharacter().charValue();</span> + +<span class="fc" id="L1418"> QuoteMode quoteModePolicy = getQuoteMode();</span> +<span class="fc bfc" id="L1419" title="All 2 branches covered."> if (quoteModePolicy == null) {</span> +<span class="fc" id="L1420"> quoteModePolicy = QuoteMode.MINIMAL;</span> + } +<span class="pc bpc" id="L1422" title="1 of 5 branches missed."> switch (quoteModePolicy) {</span> + case ALL: + case ALL_NON_NULL: +<span class="fc" id="L1425"> quote = true;</span> +<span class="fc" id="L1426"> break;</span> + case NON_NUMERIC: +<span class="fc bfc" id="L1428" title="All 2 branches covered."> quote = !(object instanceof Number);</span> +<span class="fc" id="L1429"> break;</span> + case NONE: + // Use the existing escaping code +<span class="fc" id="L1432"> printWithEscapes(value, out);</span> +<span class="fc" id="L1433"> return;</span> + case MINIMAL: +<span class="fc bfc" id="L1435" title="All 2 branches covered."> if (len <= 0) {</span> + // always quote an empty token that is the first + // on the line, as it may be the only thing on the + // line. If it were not quoted in that case, + // an empty line has no tokens. +<span class="fc bfc" id="L1440" title="All 2 branches covered."> if (newRecord) {</span> +<span class="fc" id="L1441"> quote = true;</span> + } + } else { +<span class="fc" id="L1444"> char c = value.charAt(pos);</span> + +<span class="fc bfc" id="L1446" title="All 2 branches covered."> if (c <= COMMENT) {</span> + // Some other chars at the start of a value caused the parser to fail, so for now + // encapsulate if we start in anything less than '#'. We are being conservative + // by including the default comment char too. +<span class="fc" id="L1450"> quote = true;</span> + } else { +<span class="fc bfc" id="L1452" title="All 2 branches covered."> while (pos < end) {</span> +<span class="fc" id="L1453"> c = value.charAt(pos);</span> +<span class="fc bfc" id="L1454" title="All 8 branches covered."> if (c == LF || c == CR || c == quoteChar || c == delimChar) {</span> +<span class="fc" id="L1455"> quote = true;</span> +<span class="fc" id="L1456"> break;</span> + } +<span class="fc" id="L1458"> pos++;</span> + } + +<span class="fc bfc" id="L1461" title="All 2 branches covered."> if (!quote) {</span> +<span class="fc" id="L1462"> pos = end - 1;</span> +<span class="fc" id="L1463"> c = value.charAt(pos);</span> + // Some other chars at the end caused the parser to fail, so for now + // encapsulate if we end in anything less than ' ' +<span class="fc bfc" id="L1466" title="All 2 branches covered."> if (c <= SP) {</span> +<span class="fc" id="L1467"> quote = true;</span> + } + } + } + } + +<span class="fc bfc" id="L1473" title="All 2 branches covered."> if (!quote) {</span> + // no encapsulation needed - write out the original value +<span class="fc" id="L1475"> out.append(value, start, end);</span> +<span class="fc" id="L1476"> return;</span> + } + break; + default: +<span class="nc" id="L1480"> throw new IllegalStateException("Unexpected Quote value: " + quoteModePolicy);</span> + } + +<span class="fc bfc" id="L1483" title="All 2 branches covered."> if (!quote) {</span> + // no encapsulation needed - write out the original value +<span class="fc" id="L1485"> out.append(value, start, end);</span> +<span class="fc" id="L1486"> return;</span> + } + + // we hit something that needed encapsulation +<span class="fc" id="L1490"> out.append(quoteChar);</span> + + // Pick up where we left off: pos should be positioned on the first character that caused + // the need for encapsulation. +<span class="fc bfc" id="L1494" title="All 2 branches covered."> while (pos < end) {</span> +<span class="fc" id="L1495"> final char c = value.charAt(pos);</span> +<span class="fc bfc" id="L1496" title="All 2 branches covered."> if (c == quoteChar) {</span> + // write out the chunk up until this point + + // add 1 to the length to write out the encapsulator also +<span class="fc" id="L1500"> out.append(value, start, pos + 1);</span> + // put the next starting position on the encapsulator so we will + // write it out again with the next string (effectively doubling it) +<span class="fc" id="L1503"> start = pos;</span> + } +<span class="fc" id="L1505"> pos++;</span> +<span class="fc" id="L1506"> }</span> + + // write the last segment +<span class="fc" id="L1509"> out.append(value, start, pos);</span> +<span class="fc" id="L1510"> out.append(quoteChar);</span> +<span class="fc" id="L1511"> }</span> + + /** + * Always use quotes unless QuoteMode is NONE, so we not have to look ahead. + * + * @throws IOException + */ + private void printWithQuotes(final Reader reader, final Appendable out) throws IOException { + +<span class="pc bpc" id="L1520" title="1 of 2 branches missed."> if (getQuoteMode() == QuoteMode.NONE) {</span> +<span class="nc" id="L1521"> printWithEscapes(reader, out);</span> +<span class="nc" id="L1522"> return;</span> + } + +<span class="fc" id="L1525"> int pos = 0;</span> + +<span class="fc" id="L1527"> final char quote = getQuoteCharacter().charValue();</span> +<span class="fc" id="L1528"> final StringBuilder builder = new StringBuilder(IOUtils.DEFAULT_BUFFER_SIZE);</span> + +<span class="fc" id="L1530"> out.append(quote);</span> + + int c; +<span class="fc bfc" id="L1533" title="All 2 branches covered."> while (-1 != (c = reader.read())) {</span> +<span class="fc" id="L1534"> builder.append((char) c);</span> +<span class="fc bfc" id="L1535" title="All 2 branches covered."> if (c == quote) {</span> + // write out segment up until this char +<span class="pc bpc" id="L1537" title="1 of 2 branches missed."> if (pos > 0) {</span> +<span class="fc" id="L1538"> out.append(builder.substring(0, pos));</span> +<span class="fc" id="L1539"> builder.setLength(0);</span> +<span class="fc" id="L1540"> pos = -1;</span> + } + +<span class="fc" id="L1543"> out.append(quote);</span> +<span class="fc" id="L1544"> out.append((char) c);</span> + } +<span class="fc" id="L1546"> pos++;</span> + } + + // write last segment +<span class="pc bpc" id="L1550" title="1 of 2 branches missed."> if (pos > 0) {</span> +<span class="fc" id="L1551"> out.append(builder.substring(0, pos));</span> + } + +<span class="fc" id="L1554"> out.append(quote);</span> +<span class="fc" id="L1555"> }</span> + + @Override + public String toString() { +<span class="fc" id="L1559"> final StringBuilder sb = new StringBuilder();</span> +<span class="fc" id="L1560"> sb.append("Delimiter=<").append(delimiter).append('>');</span> +<span class="fc bfc" id="L1561" title="All 2 branches covered."> if (isEscapeCharacterSet()) {</span> +<span class="fc" id="L1562"> sb.append(' ');</span> +<span class="fc" id="L1563"> sb.append("Escape=<").append(escapeCharacter).append('>');</span> + } +<span class="pc bpc" id="L1565" title="1 of 2 branches missed."> if (isQuoteCharacterSet()) {</span> +<span class="fc" id="L1566"> sb.append(' ');</span> +<span class="fc" id="L1567"> sb.append("QuoteChar=<").append(quoteCharacter).append('>');</span> + } +<span class="fc bfc" id="L1569" title="All 2 branches covered."> if (isCommentMarkerSet()) {</span> +<span class="fc" id="L1570"> sb.append(' ');</span> +<span class="fc" id="L1571"> sb.append("CommentStart=<").append(commentMarker).append('>');</span> + } +<span class="pc bpc" id="L1573" title="1 of 2 branches missed."> if (isNullStringSet()) {</span> +<span class="nc" id="L1574"> sb.append(' ');</span> +<span class="nc" id="L1575"> sb.append("NullString=<").append(nullString).append('>');</span> + } +<span class="fc bfc" id="L1577" title="All 2 branches covered."> if (recordSeparator != null) {</span> +<span class="fc" id="L1578"> sb.append(' ');</span> +<span class="fc" id="L1579"> sb.append("RecordSeparator=<").append(recordSeparator).append('>');</span> + } +<span class="fc bfc" id="L1581" title="All 2 branches covered."> if (getIgnoreEmptyLines()) {</span> +<span class="fc" id="L1582"> sb.append(" EmptyLines:ignored");</span> + } +<span class="fc bfc" id="L1584" title="All 2 branches covered."> if (getIgnoreSurroundingSpaces()) {</span> +<span class="fc" id="L1585"> sb.append(" SurroundingSpaces:ignored");</span> + } +<span class="pc bpc" id="L1587" title="1 of 2 branches missed."> if (getIgnoreHeaderCase()) {</span> +<span class="nc" id="L1588"> sb.append(" IgnoreHeaderCase:ignored");</span> + } +<span class="fc" id="L1590"> sb.append(" SkipHeaderRecord:").append(skipHeaderRecord);</span> +<span class="pc bpc" id="L1591" title="1 of 2 branches missed."> if (headerComments != null) {</span> +<span class="nc" id="L1592"> sb.append(' ');</span> +<span class="nc" id="L1593"> sb.append("HeaderComments:").append(Arrays.toString(headerComments));</span> + } +<span class="pc bpc" id="L1595" title="1 of 2 branches missed."> if (header != null) {</span> +<span class="nc" id="L1596"> sb.append(' ');</span> +<span class="nc" id="L1597"> sb.append("Header:").append(Arrays.toString(header));</span> + } +<span class="fc" id="L1599"> return sb.toString();</span> + } + + private String[] toStringArray(final Object[] values) { +<span class="fc bfc" id="L1603" title="All 2 branches covered."> if (values == null) {</span> +<span class="fc" id="L1604"> return null;</span> + } +<span class="fc" id="L1606"> final String[] strings = new String[values.length];</span> +<span class="fc bfc" id="L1607" title="All 2 branches covered."> for (int i = 0; i < values.length; i++) {</span> +<span class="fc" id="L1608"> final Object value = values[i];</span> +<span class="fc bfc" id="L1609" title="All 2 branches covered."> strings[i] = value == null ? null : value.toString();</span> + } +<span class="fc" id="L1611"> return strings;</span> + } + + private CharSequence trim(final CharSequence charSequence) { +<span class="pc bpc" id="L1615" title="1 of 2 branches missed."> if (charSequence instanceof String) {</span> +<span class="fc" id="L1616"> return ((String) charSequence).trim();</span> + } +<span class="nc" id="L1618"> final int count = charSequence.length();</span> +<span class="nc" id="L1619"> int len = count;</span> +<span class="nc" id="L1620"> int pos = 0;</span> + +<span class="nc bnc" id="L1622" title="All 4 branches missed."> while (pos < len && charSequence.charAt(pos) <= SP) {</span> +<span class="nc" id="L1623"> pos++;</span> + } +<span class="nc bnc" id="L1625" title="All 4 branches missed."> while (pos < len && charSequence.charAt(len - 1) <= SP) {</span> +<span class="nc" id="L1626"> len--;</span> + } +<span class="nc bnc" id="L1628" title="All 4 branches missed."> return pos > 0 || len < count ? charSequence.subSequence(pos, len) : charSequence;</span> + } + + /** + * Verifies the consistency of the parameters and throws an IllegalArgumentException if necessary. + * + * @throws IllegalArgumentException + */ + private void validate() throws IllegalArgumentException { +<span class="pc bpc" id="L1637" title="1 of 2 branches missed."> if (isLineBreak(delimiter)) {</span> +<span class="nc" id="L1638"> throw new IllegalArgumentException("The delimiter cannot be a line break");</span> + } + +<span class="fc bfc" id="L1641" title="All 4 branches covered."> if (quoteCharacter != null && delimiter == quoteCharacter.charValue()) {</span> +<span class="fc" id="L1642"> throw new IllegalArgumentException(</span> + "The quoteChar character and the delimiter cannot be the same ('" + quoteCharacter + "')"); + } + +<span class="fc bfc" id="L1646" title="All 4 branches covered."> if (escapeCharacter != null && delimiter == escapeCharacter.charValue()) {</span> +<span class="fc" id="L1647"> throw new IllegalArgumentException(</span> + "The escape character and the delimiter cannot be the same ('" + escapeCharacter + "')"); + } + +<span class="fc bfc" id="L1651" title="All 4 branches covered."> if (commentMarker != null && delimiter == commentMarker.charValue()) {</span> +<span class="fc" id="L1652"> throw new IllegalArgumentException(</span> + "The comment start character and the delimiter cannot be the same ('" + commentMarker + "')"); + } + +<span class="fc bfc" id="L1656" title="All 4 branches covered."> if (quoteCharacter != null && quoteCharacter.equals(commentMarker)) {</span> +<span class="fc" id="L1657"> throw new IllegalArgumentException(</span> + "The comment start character and the quoteChar cannot be the same ('" + commentMarker + "')"); + } + +<span class="fc bfc" id="L1661" title="All 4 branches covered."> if (escapeCharacter != null && escapeCharacter.equals(commentMarker)) {</span> +<span class="fc" id="L1662"> throw new IllegalArgumentException(</span> + "The comment start and the escape character cannot be the same ('" + commentMarker + "')"); + } + +<span class="fc bfc" id="L1666" title="All 4 branches covered."> if (escapeCharacter == null && quoteMode == QuoteMode.NONE) {</span> +<span class="fc" id="L1667"> throw new IllegalArgumentException("No quotes mode set but no escape character is set");</span> + } + + // validate header +<span class="fc bfc" id="L1671" title="All 2 branches covered."> if (header != null) {</span> +<span class="fc" id="L1672"> final Set<String> dupCheck = new HashSet<>();</span> +<span class="fc bfc" id="L1673" title="All 2 branches covered."> for (final String hdr : header) {</span> +<span class="fc bfc" id="L1674" title="All 2 branches covered."> if (!dupCheck.add(hdr)) {</span> +<span class="fc" id="L1675"> throw new IllegalArgumentException(</span> +<span class="fc" id="L1676"> "The header contains a duplicate entry: '" + hdr + "' in " + Arrays.toString(header));</span> + } + } + } +<span class="fc" id="L1680"> }</span> + + /** + * Returns a new {@code CSVFormat} that allows duplicate header names. + * + * @return a new {@code CSVFormat} that allows duplicate header names + * @since 1.7 + */ + public CSVFormat withAllowDuplicateHeaderNames() { +<span class="nc" id="L1689"> return withAllowDuplicateHeaderNames(true);</span> + } + + /** + * Returns a new {@code CSVFormat} with duplicate header names behavior set to the given value. + * + * @param allowDuplicateHeaderNames the duplicate header names behavior, true to allow, false to disallow. + * @return a new {@code CSVFormat} with duplicate header names behavior set to the given value. + * @since 1.7 + */ + public CSVFormat withAllowDuplicateHeaderNames(final boolean allowDuplicateHeaderNames) { +<span class="fc" id="L1700"> return new CSVFormat(delimiter, quoteCharacter, quoteMode, commentMarker, escapeCharacter,</span> + ignoreSurroundingSpaces, ignoreEmptyLines, recordSeparator, nullString, headerComments, header, + skipHeaderRecord, allowMissingColumnNames, ignoreHeaderCase, trim, trailingDelimiter, autoFlush, + allowDuplicateHeaderNames); + } + + /** + * Returns a new {@code CSVFormat} with the missing column names behavior of the format set to {@code true} + * + * @return A new CSVFormat that is equal to this but with the specified missing column names behavior. + * @see #withAllowMissingColumnNames(boolean) + * @since 1.1 + */ + public CSVFormat withAllowMissingColumnNames() { +<span class="fc" id="L1714"> return this.withAllowMissingColumnNames(true);</span> + } + + /** + * Returns a new {@code CSVFormat} with the missing column names behavior of the format set to the given value. + * + * @param allowMissingColumnNames + * the missing column names behavior, {@code true} to allow missing column names in the header line, + * {@code false} to cause an {@link IllegalArgumentException} to be thrown. + * @return A new CSVFormat that is equal to this but with the specified missing column names behavior. + */ + public CSVFormat withAllowMissingColumnNames(final boolean allowMissingColumnNames) { +<span class="fc" id="L1726"> return new CSVFormat(delimiter, quoteCharacter, quoteMode, commentMarker, escapeCharacter,</span> + ignoreSurroundingSpaces, ignoreEmptyLines, recordSeparator, nullString, headerComments, header, + skipHeaderRecord, allowMissingColumnNames, ignoreHeaderCase, trim, trailingDelimiter, autoFlush, + allowDuplicateHeaderNames); + } + + /** + * Returns a new {@code CSVFormat} with whether to flush on close. + * + * @param autoFlush + * whether to flush on close. + * + * @return A new CSVFormat that is equal to this but with the specified autoFlush setting. + * @since 1.6 + */ + public CSVFormat withAutoFlush(final boolean autoFlush) { +<span class="fc" id="L1742"> return new CSVFormat(delimiter, quoteCharacter, quoteMode, commentMarker, escapeCharacter,</span> + ignoreSurroundingSpaces, ignoreEmptyLines, recordSeparator, nullString, headerComments, header, + skipHeaderRecord, allowMissingColumnNames, ignoreHeaderCase, trim, trailingDelimiter, autoFlush, + allowDuplicateHeaderNames); + } + + /** + * Returns a new {@code CSVFormat} with the comment start marker of the format set to the specified character. + * + * Note that the comment start character is only recognized at the start of a line. + * + * @param commentMarker + * the comment start marker + * @return A new CSVFormat that is equal to this one but with the specified character as the comment start marker + * @throws IllegalArgumentException + * thrown if the specified character is a line break + */ + public CSVFormat withCommentMarker(final char commentMarker) { +<span class="fc" id="L1760"> return withCommentMarker(Character.valueOf(commentMarker));</span> + } + + /** + * Returns a new {@code CSVFormat} with the comment start marker of the format set to the specified character. + * + * Note that the comment start character is only recognized at the start of a line. + * + * @param commentMarker + * the comment start marker, use {@code null} to disable + * @return A new CSVFormat that is equal to this one but with the specified character as the comment start marker + * @throws IllegalArgumentException + * thrown if the specified character is a line break + */ + public CSVFormat withCommentMarker(final Character commentMarker) { +<span class="fc bfc" id="L1775" title="All 2 branches covered."> if (isLineBreak(commentMarker)) {</span> +<span class="fc" id="L1776"> throw new IllegalArgumentException("The comment start marker character cannot be a line break");</span> + } +<span class="fc" id="L1778"> return new CSVFormat(delimiter, quoteCharacter, quoteMode, commentMarker, escapeCharacter,</span> + ignoreSurroundingSpaces, ignoreEmptyLines, recordSeparator, nullString, headerComments, header, + skipHeaderRecord, allowMissingColumnNames, ignoreHeaderCase, trim, trailingDelimiter, autoFlush, + allowDuplicateHeaderNames); + } + + /** + * Returns a new {@code CSVFormat} with the delimiter of the format set to the specified character. + * + * @param delimiter + * the delimiter character + * @return A new CSVFormat that is equal to this with the specified character as delimiter + * @throws IllegalArgumentException + * thrown if the specified character is a line break + */ + public CSVFormat withDelimiter(final char delimiter) { +<span class="fc bfc" id="L1794" title="All 2 branches covered."> if (isLineBreak(delimiter)) {</span> +<span class="fc" id="L1795"> throw new IllegalArgumentException("The delimiter cannot be a line break");</span> + } +<span class="fc" id="L1797"> return new CSVFormat(delimiter, quoteCharacter, quoteMode, commentMarker, escapeCharacter,</span> + ignoreSurroundingSpaces, ignoreEmptyLines, recordSeparator, nullString, headerComments, header, + skipHeaderRecord, allowMissingColumnNames, ignoreHeaderCase, trim, trailingDelimiter, autoFlush, + allowDuplicateHeaderNames); + } + + /** + * Returns a new {@code CSVFormat} with the escape character of the format set to the specified character. + * + * @param escape + * the escape character + * @return A new CSVFormat that is equal to his but with the specified character as the escape character + * @throws IllegalArgumentException + * thrown if the specified character is a line break + */ + public CSVFormat withEscape(final char escape) { +<span class="fc" id="L1813"> return withEscape(Character.valueOf(escape));</span> + } + + /** + * Returns a new {@code CSVFormat} with the escape character of the format set to the specified character. + * + * @param escape + * the escape character, use {@code null} to disable + * @return A new CSVFormat that is equal to this but with the specified character as the escape character + * @throws IllegalArgumentException + * thrown if the specified character is a line break + */ + public CSVFormat withEscape(final Character escape) { +<span class="fc bfc" id="L1826" title="All 2 branches covered."> if (isLineBreak(escape)) {</span> +<span class="fc" id="L1827"> throw new IllegalArgumentException("The escape character cannot be a line break");</span> + } +<span class="fc" id="L1829"> return new CSVFormat(delimiter, quoteCharacter, quoteMode, commentMarker, escape, ignoreSurroundingSpaces,</span> + ignoreEmptyLines, recordSeparator, nullString, headerComments, header, skipHeaderRecord, + allowMissingColumnNames, ignoreHeaderCase, trim, trailingDelimiter, autoFlush, + allowDuplicateHeaderNames); + } + + /** + * Returns a new {@code CSVFormat} using the first record as header. + * + * <p> + * Calling this method is equivalent to calling: + * </p> + * + * <pre> + * CSVFormat format = aFormat.withHeader().withSkipHeaderRecord(); + * </pre> + * + * @return A new CSVFormat that is equal to this but using the first record as header. + * @see #withSkipHeaderRecord(boolean) + * @see #withHeader(String...) + * @since 1.3 + */ + public CSVFormat withFirstRecordAsHeader() { +<span class="fc" id="L1852"> return withHeader().withSkipHeaderRecord();</span> + } + + /** + * Returns a new {@code CSVFormat} with the header of the format defined by the enum class. + * + * <p> + * Example: + * </p> + * + * <pre> + * public enum Header { + * Name, Email, Phone + * } + * + * CSVFormat format = aformat.withHeader(Header.class); + * </pre> + * <p> + * The header is also used by the {@link CSVPrinter}. + * </p> + * + * @param headerEnum + * the enum defining the header, {@code null} if disabled, empty if parsed automatically, user specified + * otherwise. + * + * @return A new CSVFormat that is equal to this but with the specified header + * @see #withHeader(String...) + * @see #withSkipHeaderRecord(boolean) + * @since 1.3 + */ + public CSVFormat withHeader(final Class<? extends Enum<?>> headerEnum) { +<span class="fc" id="L1883"> String[] header = null;</span> +<span class="pc bpc" id="L1884" title="1 of 2 branches missed."> if (headerEnum != null) {</span>
[... 413 lines stripped ...]