Modified: websites/production/commons/content/proper/commons-csv/taglist.html ============================================================================== --- websites/production/commons/content/proper/commons-csv/taglist.html (original) +++ websites/production/commons/content/proper/commons-csv/taglist.html Sat Jan 11 14:23:31 2025 @@ -1,15 +1,13 @@ <!DOCTYPE html> <!-- - | Generated by Apache Maven Doxia at 04 January 2025 - | Rendered using Apache Maven Fluido Skin 1.3.0 + | Generated by Apache Maven Doxia Site Renderer 2.0.0 from org.codehaus.mojo:taglist-maven-plugin:3.2.1:taglist at 11 Jan 2025 + | Rendered using Apache Commons Skin --> -<html xmlns="http://www.w3.org/1999/xhtml"; xml:lang="en" lang="en"> +<html xmlns="http://www.w3.org/1999/xhtml"; lang="en"> <head> <meta charset="UTF-8" /> <meta name="viewport" content="width=device-width, initial-scale=1.0" /> - <meta name="Date-Revision-yyyymmdd" content="20250104" /> - <meta http-equiv="Content-Language" content="en" /> - <title>Commons CSV – Tag List report</title> + <title>Tag List report â Commons CSV</title> <link rel="stylesheet" href="./css/bootstrap.min.css" type="text/css" /> <link rel="stylesheet" href="./css/site.css" type="text/css" /> @@ -24,11 +22,11 @@ </head> <body class="composite"> - <a href="https://commons.apache.org/"; id="bannerLeft" title="Apache Commons logo"> + <a href="https://commons.apache.org/"; id="bannerLeft"> <img class="logo-left" src=" ./images/commons-logo.png " alt="Apache Commons logo"/> </a> - <a href="index.html" id="bannerRight" title="Apache Commons CSV™ logo"> + <a href="index.html" id="bannerRight"> <img class="logo-right" src=" images/logo.png " alt="Apache Commons CSV™ logo"/> </a> @@ -38,10 +36,9 @@ <div class="navbar-inner"> <div class="container-fluid"> <a class="brand" href="https://commons.apache.org/proper/commons-csv/";>Apache Commons CSV ™</a> - <ul class="nav"> - - <li id="publishDate">Last Published: 04 January 2025</li> - <li class="divider">|</li> <li id="projectVersion">Version: 1.13.0-SNAPSHOT</li> + <ul class="nav"> + <li id="publishDate">Last Published: 08 Jan 2025</li> + <li class="divider">|</li> <li id="projectVersion">Version: 1.13.0</li> </ul> <div class="pull-right"> <ul class="nav"> <li> @@ -91,7 +88,7 @@ </li> </ul> <ul class="nav nav-list"> - <li class="nav-header"><i class="icon-cog"></i>Development</li> + <li class="nav-header">Development</li> <li class="none"> <a href="changes-report.html" title="History"> History</a> @@ -114,7 +111,7 @@ </li> </ul> <ul class="nav nav-list"> - <li class="nav-header"><i class="icon-info-sign"></i>Project Documentation</li> + <li class="nav-header">Project Documentation</li> <li class="collapsed"> <a href="project-info.html" title="Project Information"> Project Information</a> @@ -124,11 +121,11 @@ Project Reports</a> <ul> <li class="none"> - <a href="changes-report.html" title="Changes"> + <a href="changes.html" title="Changes"> Changes</a> </li> <li class="none"> - <a href="jira-report.html" title="JIRA Report"> + <a href="jira-changes.html" title="JIRA Report"> JIRA Report</a> </li> <li class="none"> @@ -290,10 +287,10 @@ </div> </td> <td class="content"> - <section><a name="Tag_List_Report"></a> -<h2><a name="Tag_List_Report"></a>Tag List Report</h2> + <section><a id="Tag_List_Report"></a> +<h1>Tag List Report</h1> <p>The following document contains the listing of user tags found in the code. Below is the summary of the occurrences per tag.</p> -<table border="0" class="bodyTable"> +<table class="bodyTable"> <tr class="a"> <th>Tag Class</th> <th>Total number of occurrences</th> @@ -306,10 +303,10 @@ <td>Notable Markers</td> <td>0</td> <td>NOTE, NOPMD, NOSONAR</td></tr></table> -<p>Each tag is detailed below:</p><section><a name="tag_class_1"></a> -<h3><a name="Needs_Work"></a>Needs Work</h3> +<p>Each tag is detailed below:</p><section><a id="tag_class_1"></a> +<h2>Needs Work</h2> <p>Number of occurrences found in the code: 9</p> -<table border="0" class="bodyTable"> +<table class="bodyTable"> <tr class="a"> <th>org.apache.commons.csv.CSVParserTest</th> <th>Line</th></tr> @@ -327,16 +324,16 @@ <th>Line</th></tr> <tr class="b"> <td>escape handling needs more work</td> -<td><a href="./xref/org/apache/commons/csv/Lexer.html#L469">469</a></td></tr> +<td><a href="./xref/org/apache/commons/csv/Lexer.html#L471">471</a></td></tr> <tr class="a"> <td>is this correct?</td> -<td><a href="./xref/org/apache/commons/csv/Lexer.html#L494">494</a></td></tr> +<td><a href="./xref/org/apache/commons/csv/Lexer.html#L496">496</a></td></tr> <tr class="b"> <td>is this correct? Do tabs need to be escaped?</td> -<td><a href="./xref/org/apache/commons/csv/Lexer.html#L495">495</a></td></tr> +<td><a href="./xref/org/apache/commons/csv/Lexer.html#L497">497</a></td></tr> <tr class="a"> <td>is this correct?</td> -<td><a href="./xref/org/apache/commons/csv/Lexer.html#L496">496</a></td></tr> +<td><a href="./xref/org/apache/commons/csv/Lexer.html#L498">498</a></td></tr> <tr class="b"> <th>org.apache.commons.csv.LexerTest</th> <th>Line</th></tr> @@ -358,10 +355,7 @@ <p>Copyright © 2005-2025 <a href="https://www.apache.org/";>The Apache Software Foundation</a>. All Rights Reserved.</p> - -<div class="center">Apache Commons, Apache Commons CSV, Apache, the Apache feather logo, and the Apache Commons project logos are trademarks of The Apache Software Foundation. - All other marks mentioned may be trademarks or registered trademarks of their respective owners.</div> - </div> + </div> </body> </html> \ No newline at end of file
Modified: websites/production/commons/content/proper/commons-csv/team.html ============================================================================== --- websites/production/commons/content/proper/commons-csv/team.html (original) +++ websites/production/commons/content/proper/commons-csv/team.html Sat Jan 11 14:23:31 2025 @@ -1,15 +1,13 @@ <!DOCTYPE html> <!-- - | Generated by Apache Maven Doxia at 04 January 2025 - | Rendered using Apache Maven Fluido Skin 1.3.0 + | Generated by Apache Maven Doxia Site Renderer 2.0.0 from org.apache.maven.plugins:maven-project-info-reports-plugin:3.8.0:team at 11 Jan 2025 + | Rendered using Apache Commons Skin --> -<html xmlns="http://www.w3.org/1999/xhtml"; xml:lang="en" lang="en"> +<html xmlns="http://www.w3.org/1999/xhtml"; lang="en"> <head> <meta charset="UTF-8" /> <meta name="viewport" content="width=device-width, initial-scale=1.0" /> - <meta name="Date-Revision-yyyymmdd" content="20250104" /> - <meta http-equiv="Content-Language" content="en" /> - <title>Commons CSV – Project Team</title> + <title>Project Team â Commons CSV</title> <link rel="stylesheet" href="./css/bootstrap.min.css" type="text/css" /> <link rel="stylesheet" href="./css/site.css" type="text/css" /> @@ -24,11 +22,11 @@ </head> <body class="composite"> - <a href="https://commons.apache.org/"; id="bannerLeft" title="Apache Commons logo"> + <a href="https://commons.apache.org/"; id="bannerLeft"> <img class="logo-left" src=" ./images/commons-logo.png " alt="Apache Commons logo"/> </a> - <a href="index.html" id="bannerRight" title="Apache Commons CSV™ logo"> + <a href="index.html" id="bannerRight"> <img class="logo-right" src=" images/logo.png " alt="Apache Commons CSV™ logo"/> </a> @@ -38,10 +36,9 @@ <div class="navbar-inner"> <div class="container-fluid"> <a class="brand" href="https://commons.apache.org/proper/commons-csv/";>Apache Commons CSV ™</a> - <ul class="nav"> - - <li id="publishDate">Last Published: 04 January 2025</li> - <li class="divider">|</li> <li id="projectVersion">Version: 1.13.0-SNAPSHOT</li> + <ul class="nav"> + <li id="publishDate">Last Published: 08 Jan 2025</li> + <li class="divider">|</li> <li id="projectVersion">Version: 1.13.0</li> </ul> <div class="pull-right"> <ul class="nav"> <li> @@ -91,7 +88,7 @@ </li> </ul> <ul class="nav nav-list"> - <li class="nav-header"><i class="icon-cog"></i>Development</li> + <li class="nav-header">Development</li> <li class="none"> <a href="changes-report.html" title="History"> History</a> @@ -114,7 +111,7 @@ </li> </ul> <ul class="nav nav-list"> - <li class="nav-header"><i class="icon-info-sign"></i>Project Documentation</li> + <li class="nav-header">Project Documentation</li> <li class="expanded"> <a href="project-info.html" title="Project Information"> Project Information</a> @@ -282,13 +279,13 @@ </div> </td> <td class="content"> - <section> -<h2><a name="Project_Team"></a>Project Team</h2><a name="Project_Team"></a> + <section><a id="Project_Team"></a> +<h1>Project Team</h1> <p>A successful project requires many people to play many roles. Some members write code or documentation, while others are valuable as testers, submitting patches and suggestions.</p> -<p>The project team is comprised of Members and Contributors. Members have direct access to the source of a project and actively evolve the code-base. Contributors improve the project through submission of patches and suggestions to the Members. The number of Contributors to the project is unbounded. Get involved today. All contributions to the project are greatly appreciated.</p><section> -<h3><a name="Members"></a>Members</h3><a name="Members"></a> +<p>The project team is comprised of Members and Contributors. Members have direct access to the source of a project and actively evolve the code-base. Contributors improve the project through submission of patches and suggestions to the Members. The number of Contributors to the project is unbounded. Get involved today. All contributions to the project are greatly appreciated.</p><section><a id="Members"></a> +<h2>Members</h2> <p>The following is a list of developers with commit privileges that have directly contributed to the project in one way or another.</p> -<table border="0" class="bodyTable"> +<table class="bodyTable"> <tr class="a"> <th>Image</th> <th>Id</th> @@ -300,8 +297,8 @@ <th>Roles</th> <th>Time Zone</th></tr> <tr class="b"> -<td align="left"><figure><img src="https://www.gravatar.com/avatar/4156866f23b66d5ca7df5cdc86cb9a0e?d=mm&s=60"; alt="" /></figure></td> -<td><a name="bayard"></a>bayard</td> +<td><figure><img src="https://www.gravatar.com/avatar/4156866f23b66d5ca7df5cdc86cb9a0e?d=mm&s=60"; /></figure></td> +<td><a id="bayard"></a>bayard</td> <td>Henri Yandell</td> <td><a class="externalLink" href="mailto:[email protected]";>[email protected]</a></td> <td>-</td> @@ -310,8 +307,8 @@ <td>-</td> <td>-</td></tr> <tr class="a"> -<td align="left"><figure><img src="https://www.gravatar.com/avatar/77e72680b92db81abf2e41e9c5ed3525?d=mm&s=60"; alt="" /></figure></td> -<td><a name="mvdb"></a>mvdb</td> +<td><figure><img src="https://www.gravatar.com/avatar/77e72680b92db81abf2e41e9c5ed3525?d=mm&s=60"; /></figure></td> +<td><a id="mvdb"></a>mvdb</td> <td>Martin van den Bemt</td> <td><a class="externalLink" href="mailto:[email protected]";>[email protected]</a></td> <td>-</td> @@ -320,8 +317,8 @@ <td>-</td> <td>-</td></tr> <tr class="b"> -<td align="left"><figure><img src="https://www.gravatar.com/avatar/c142081bd84e031f1951dc8fa42745f2?d=mm&s=60"; alt="" /></figure></td> -<td><a name="yonik"></a>yonik</td> +<td><figure><img src="https://www.gravatar.com/avatar/c142081bd84e031f1951dc8fa42745f2?d=mm&s=60"; /></figure></td> +<td><a id="yonik"></a>yonik</td> <td>Yonik Seeley</td> <td><a class="externalLink" href="mailto:[email protected]";>[email protected]</a></td> <td>-</td> @@ -330,8 +327,8 @@ <td>-</td> <td>-</td></tr> <tr class="a"> -<td align="left"><figure><img src="https://www.gravatar.com/avatar/8304c64641badd4218a89a5f97d2ae86?d=mm&s=60"; alt="" /></figure></td> -<td><a name="ebourg"></a>ebourg</td> +<td><figure><img src="https://www.gravatar.com/avatar/8304c64641badd4218a89a5f97d2ae86?d=mm&s=60"; /></figure></td> +<td><a id="ebourg"></a>ebourg</td> <td>Emmanuel Bourg</td> <td><a class="externalLink" href="mailto:[email protected]";>[email protected]</a></td> <td>-</td> @@ -340,8 +337,8 @@ <td>-</td> <td>-</td></tr> <tr class="b"> -<td align="left"><figure><img src="https://people.apache.org/~ggregory/img/garydgregory80.png"; alt="" /></figure></td> -<td><a name="ggregory"></a>ggregory</td> +<td><figure><img src="https://people.apache.org/~ggregory/img/garydgregory80.png"; /></figure></td> +<td><a id="ggregory"></a>ggregory</td> <td>Gary Gregory</td> <td><a class="externalLink" href="mailto:ggregory at apache.org">ggregory at apache.org</a></td> <td><a class="externalLink" href="https://www.garygregory.com";>https://www.garygregory.com</a></td> @@ -350,8 +347,8 @@ <td>PMC Member</td> <td>America/New_York</td></tr> <tr class="a"> -<td align="left"><figure><img src="https://www.gravatar.com/avatar/cbfb61ee7f8641b2b6eaf22fed163b1e?d=mm&s=60"; alt="" /></figure></td> -<td><a name="britter"></a>britter</td> +<td><figure><img src="https://www.gravatar.com/avatar/cbfb61ee7f8641b2b6eaf22fed163b1e?d=mm&s=60"; /></figure></td> +<td><a id="britter"></a>britter</td> <td>Benedikt Ritter</td> <td><a class="externalLink" href="mailto:[email protected]";>[email protected]</a></td> <td>-</td> @@ -360,22 +357,22 @@ <td>-</td> <td>-</td></tr> <tr class="b"> -<td align="left"><figure><img src="https://www.gravatar.com/avatar/a010ac0916b6b9b10883e9359cfcd7f9?d=mm&s=60"; alt="" /></figure></td> -<td><a name="chtompki"></a>chtompki</td> +<td><figure><img src="https://www.gravatar.com/avatar/a010ac0916b6b9b10883e9359cfcd7f9?d=mm&s=60"; /></figure></td> +<td><a id="chtompki"></a>chtompki</td> <td>Rob Tompkins</td> <td><a class="externalLink" href="mailto:[email protected]";>[email protected]</a></td> <td>-</td> <td>The Apache Software Foundation</td> <td>-</td> <td>-</td> -<td>-</td></tr></table></section><section> -<h3><a name="Contributors"></a>Contributors</h3><a name="Contributors"></a> +<td>-</td></tr></table></section><section><a id="Contributors"></a> +<h2>Contributors</h2> <p>The following additional people have contributed to this project through the way of suggestions, patches or documentation.</p> -<table border="0" class="bodyTable"> +<table class="bodyTable"> <tr class="a"> <th>Name</th></tr> <tr class="b"> -<td align="left">Bob Smith</td></tr></table></section></section> +<td>Bob Smith</td></tr></table></section></section> </td> </tr> </table> @@ -385,10 +382,7 @@ <p>Copyright © 2005-2025 <a href="https://www.apache.org/";>The Apache Software Foundation</a>. All Rights Reserved.</p> - -<div class="center">Apache Commons, Apache Commons CSV, Apache, the Apache feather logo, and the Apache Commons project logos are trademarks of The Apache Software Foundation. - All other marks mentioned may be trademarks or registered trademarks of their respective owners.</div> - </div> + </div> </body> </html> \ No newline at end of file Modified: websites/production/commons/content/proper/commons-csv/user-guide.html ============================================================================== --- websites/production/commons/content/proper/commons-csv/user-guide.html (original) +++ websites/production/commons/content/proper/commons-csv/user-guide.html Sat Jan 11 14:23:31 2025 @@ -1,16 +1,14 @@ <!DOCTYPE html> <!-- - | Generated by Apache Maven Doxia at 04 January 2025 - | Rendered using Apache Maven Fluido Skin 1.3.0 + | Generated by Apache Maven Doxia Site Renderer 2.0.0 from src/site/xdoc/user-guide.xml at 11 Jan 2025 + | Rendered using Apache Commons Skin --> -<html xmlns="http://www.w3.org/1999/xhtml"; xml:lang="en" lang="en"> +<html xmlns="http://www.w3.org/1999/xhtml"; lang="en"> <head> <meta charset="UTF-8" /> <meta name="viewport" content="width=device-width, initial-scale=1.0" /> <meta name="author" content="Apache Commons Documentation Team" /> - <meta name="Date-Revision-yyyymmdd" content="20250104" /> - <meta http-equiv="Content-Language" content="en" /> - <title>Commons CSV – User Guide</title> + <title>User Guide â Commons CSV</title> <link rel="stylesheet" href="./css/bootstrap.min.css" type="text/css" /> <link rel="stylesheet" href="./css/site.css" type="text/css" /> @@ -25,11 +23,11 @@ </head> <body class="composite"> - <a href="https://commons.apache.org/"; id="bannerLeft" title="Apache Commons logo"> + <a href="https://commons.apache.org/"; id="bannerLeft"> <img class="logo-left" src=" ./images/commons-logo.png " alt="Apache Commons logo"/> </a> - <a href="index.html" id="bannerRight" title="Apache Commons CSV™ logo"> + <a href="index.html" id="bannerRight"> <img class="logo-right" src=" images/logo.png " alt="Apache Commons CSV™ logo"/> </a> @@ -39,10 +37,9 @@ <div class="navbar-inner"> <div class="container-fluid"> <a class="brand" href="https://commons.apache.org/proper/commons-csv/";>Apache Commons CSV ™</a> - <ul class="nav"> - - <li id="publishDate">Last Published: 04 January 2025</li> - <li class="divider">|</li> <li id="projectVersion">Version: 1.13.0-SNAPSHOT</li> + <ul class="nav"> + <li id="publishDate">Last Published: 08 Jan 2025</li> + <li class="divider">|</li> <li id="projectVersion">Version: 1.13.0</li> </ul> <div class="pull-right"> <ul class="nav"> <li> @@ -92,7 +89,7 @@ </li> </ul> <ul class="nav nav-list"> - <li class="nav-header"><i class="icon-cog"></i>Development</li> + <li class="nav-header">Development</li> <li class="none"> <a href="changes-report.html" title="History"> History</a> @@ -115,7 +112,7 @@ </li> </ul> <ul class="nav nav-list"> - <li class="nav-header"><i class="icon-info-sign"></i>Project Documentation</li> + <li class="nav-header">Project Documentation</li> <li class="collapsed"> <a href="project-info.html" title="Project Information"> Project Information</a> @@ -237,14 +234,17 @@ - <h1>Apache Commons CSV User Guide</h1> + <section><a id="Apache_Commons_CSV_User_Guide"></a> +<h1>Apache Commons CSV User Guide</h1> <ul> +<li><a href="#Apache_Commons_CSV_User_Guide">Apache Commons CSV User Guide</a> +<ul> <li><a href="#Parsing_files">Parsing files</a> <ul> -<li><a href="#Example:_Parsing_an_Excel_CSV_File">Example: Parsing an Excel CSV File</a></li> +<li><a href="#Example.3A_Parsing_an_Excel_CSV_File">Example: Parsing an Excel CSV File</a></li> <li><a href="#Handling_Byte_Order_Marks">Handling Byte Order Marks</a></li></ul></li> <li><a href="#Working_with_headers">Working with headers</a> <ul> @@ -252,10 +252,10 @@ <li><a href="#Defining_a_header_manually">Defining a header manually</a></li> <li><a href="#Using_an_enum_to_define_a_header">Using an enum to define a header</a></li> <li><a href="#Header_auto_detection">Header auto detection</a></li> -<li><a href="#Printing_with_headers">Printing with headers</a></li></ul></li></ul> +<li><a href="#Printing_with_headers">Printing with headers</a></li></ul></li></ul></li></ul> - <section> -<h2><a name="Parsing_files"></a>Parsing files</h2> + <section><a id="Parsing_files"></a> +<h1>Parsing files</h1> Parsing files with Apache Commons CSV is relatively straight forward. The CSVFormat class provides some commonly used CSV variants: @@ -263,74 +263,72 @@ <dl> -<dt><a class="externalLink" href="https://commons.apache.org/proper/commons-csv/apidocs/org/apache/commons/csv/CSVFormat.html#DEFAULT";>DEFAULT</a></dt> +<dt><a href="https://commons.apache.org/proper/commons-csv/apidocs/org/apache/commons/csv/CSVFormat.html#DEFAULT"; class="externalLink">DEFAULT</a></dt> <dd>Standard Comma Separated Value format, as for RFC4180 but allowing empty lines.</dd> -<dt><a class="externalLink" href="https://commons.apache.org/proper/commons-csv/apidocs/org/apache/commons/csv/CSVFormat.html#EXCEL";>EXCEL</a></dt> +<dt><a href="https://commons.apache.org/proper/commons-csv/apidocs/org/apache/commons/csv/CSVFormat.html#EXCEL"; class="externalLink">EXCEL</a></dt> <dd>The Microsoft Excel CSV format.</dd> -<dt><a class="externalLink" href="https://commons.apache.org/proper/commons-csv/apidocs/org/apache/commons/csv/CSVFormat.html#INFORMIX_UNLOAD";>INFORMIX_UNLOAD<sup>1.3</sup></a></dt> -<dd>Informix <a class="externalLink" href="http://www.ibm.com/support/knowledgecenter/SSBJG3_2.5.0/com.ibm.gen_busug.doc/c_fgl_InOutSql_UNLOAD.htm";>UNLOAD</a> format used by the <code>UNLOAD TO file_name</code> operation.</dd> +<dt><a href="https://commons.apache.org/proper/commons-csv/apidocs/org/apache/commons/csv/CSVFormat.html#INFORMIX_UNLOAD"; class="externalLink">INFORMIX_UNLOAD<sup>1.3</sup></a></dt> +<dd>Informix <a href="http://www.ibm.com/support/knowledgecenter/SSBJG3_2.5.0/com.ibm.gen_busug.doc/c_fgl_InOutSql_UNLOAD.htm"; class="externalLink">UNLOAD</a> format used by the <code>UNLOAD TO file_name</code> operation.</dd> -<dt><a class="externalLink" href="https://commons.apache.org/proper/commons-csv/apidocs/org/apache/commons/csv/CSVFormat.html#INFORMIX_UNLOAD_CSV";>INFORMIX_UNLOAD_CSV<sup>1.3</sup></a></dt> -<dd>Informix <a class="externalLink" href="http://www.ibm.com/support/knowledgecenter/SSBJG3_2.5.0/com.ibm.gen_busug.doc/c_fgl_InOutSql_UNLOAD.htm";>CSV UNLOAD</a> format used by the <code>UNLOAD TO file_name</code> operation (escaping is disabled.)</dd> +<dt><a href="https://commons.apache.org/proper/commons-csv/apidocs/org/apache/commons/csv/CSVFormat.html#INFORMIX_UNLOAD_CSV"; class="externalLink">INFORMIX_UNLOAD_CSV<sup>1.3</sup></a></dt> +<dd>Informix <a href="http://www.ibm.com/support/knowledgecenter/SSBJG3_2.5.0/com.ibm.gen_busug.doc/c_fgl_InOutSql_UNLOAD.htm"; class="externalLink">CSV UNLOAD</a> format used by the <code>UNLOAD TO file_name</code> operation (escaping is disabled.)</dd> -<dt><a class="externalLink" href="https://commons.apache.org/proper/commons-csv/apidocs/org/apache/commons/csv/CSVFormat.html#MYSQL";>MONGO_CSV<sup>1.7</sup></a></dt> +<dt><a href="https://commons.apache.org/proper/commons-csv/apidocs/org/apache/commons/csv/CSVFormat.html#MYSQL"; class="externalLink">MONGO_CSV<sup>1.7</sup></a></dt> <dd>MongoDB CSV format used by the <code>mongoexport</code> operation.</dd> -<dt><a class="externalLink" href="https://commons.apache.org/proper/commons-csv/apidocs/org/apache/commons/csv/CSVFormat.html#MYSQL";>MONGO_TSV<sup>1.7</sup></a></dt> +<dt><a href="https://commons.apache.org/proper/commons-csv/apidocs/org/apache/commons/csv/CSVFormat.html#MYSQL"; class="externalLink">MONGO_TSV<sup>1.7</sup></a></dt> <dd>MongoDB TSV format used by the <code>mongoexport</code> operation.</dd> -<dt><a class="externalLink" href="https://commons.apache.org/proper/commons-csv/apidocs/org/apache/commons/csv/CSVFormat.html#MYSQL";>MYSQL</a></dt> +<dt><a href="https://commons.apache.org/proper/commons-csv/apidocs/org/apache/commons/csv/CSVFormat.html#MYSQL"; class="externalLink">MYSQL</a></dt> <dd>The MySQL CSV format.</dd> -<dt><a class="externalLink" href="https://commons.apache.org/proper/commons-csv/apidocs/org/apache/commons/csv/CSVFormat.html#ORACLE";>ORACLE<sup>1.6</sup></a></dt> +<dt><a href="https://commons.apache.org/proper/commons-csv/apidocs/org/apache/commons/csv/CSVFormat.html#ORACLE"; class="externalLink">ORACLE<sup>1.6</sup></a></dt> <dd>Default Oracle format used by the SQL*Loader utility.</dd> -<dt><a class="externalLink" href="https://commons.apache.org/proper/commons-csv/apidocs/org/apache/commons/csv/CSVFormat.html#POSTGRESSQL_CSV";>POSTGRESSQL_CSV<sup>1.5</sup></a></dt> +<dt><a href="https://commons.apache.org/proper/commons-csv/apidocs/org/apache/commons/csv/CSVFormat.html#POSTGRESSQL_CSV"; class="externalLink">POSTGRESSQL_CSV<sup>1.5</sup></a></dt> <dd>Default PostgreSQL CSV format used by the COPY operation.</dd> -<dt><a class="externalLink" href="https://commons.apache.org/proper/commons-csv/apidocs/org/apache/commons/csv/CSVFormat.html#POSTGRESSQL_TEXT";>POSTGRESSQL_TEXT<sup>1.5</sup></a></dt> +<dt><a href="https://commons.apache.org/proper/commons-csv/apidocs/org/apache/commons/csv/CSVFormat.html#POSTGRESSQL_TEXT"; class="externalLink">POSTGRESSQL_TEXT<sup>1.5</sup></a></dt> <dd>Default PostgreSQL text format used by the COPY operation.</dd> -<dt><a class="externalLink" href="https://commons.apache.org/proper/commons-csv/apidocs/org/apache/commons/csv/CSVFormat.html#RFC4180";>RFC-4180</a></dt> -<dd>The RFC-4180 format defined by <a class="externalLink" href="https://datatracker.ietf.org/doc/html/rfc4180";>RFC-4180</a>.</dd> +<dt><a href="https://commons.apache.org/proper/commons-csv/apidocs/org/apache/commons/csv/CSVFormat.html#RFC4180"; class="externalLink">RFC-4180</a></dt> +<dd>The RFC-4180 format defined by <a href="https://datatracker.ietf.org/doc/html/rfc4180"; class="externalLink">RFC-4180</a>.</dd> -<dt><a class="externalLink" href="https://commons.apache.org/proper/commons-csv/apidocs/org/apache/commons/csv/CSVFormat.html#TDF";>TDF</a></dt> +<dt><a href="https://commons.apache.org/proper/commons-csv/apidocs/org/apache/commons/csv/CSVFormat.html#TDF"; class="externalLink">TDF</a></dt> <dd>A tab delimited format.</dd> </dl> - <section> -<h3><a name="Example:_Parsing_an_Excel_CSV_File"></a>Example: Parsing an Excel CSV File</h3> + <section><a id="Example.3A_Parsing_an_Excel_CSV_File"></a> +<h2>Example: Parsing an Excel CSV File</h2> <p>To parse an Excel CSV file, write:</p> -<div class="source"> -<pre>Reader in = new FileReader("path/to/file.csv"); +<pre><code>Reader in = new FileReader("path/to/file.csv"); Iterable<CSVRecord> records = CSVFormat.EXCEL.parse(in); for (CSVRecord record : records) { String lastName = record.get("Last Name"); String firstName = record.get("First Name"); } - </pre></div> + </code></pre> </section> - <section> -<h3><a name="Handling_Byte_Order_Marks"></a>Handling Byte Order Marks</h3> + <section><a id="Handling_Byte_Order_Marks"></a> +<h2>Handling Byte Order Marks</h2> <p> To handle files that start with a Byte Order Mark (BOM) like some Excel CSV files, you need an extra step to deal with these optional bytes. You can use the - <a class="externalLink" href="https://commons.apache.org/proper/commons-io/apidocs/org/apache/commons/io/input/BOMInputStream.html";> + <a href="https://commons.apache.org/proper/commons-io/apidocs/org/apache/commons/io/input/BOMInputStream.html"; class="externalLink"> BOMInputStream </a> class from - <a class="externalLink" href="https://commons.apache.org/proper/commons-io/";>Apache Commons IO</a> + <a href="https://commons.apache.org/proper/commons-io/"; class="externalLink">Apache Commons IO</a> for example: </p> -<div class="source"> -<pre> +<pre><code> try (Reader reader = new InputStreamReader(BOMInputStream.builder() .setPath(path) .get(), "UTF-8"); @@ -343,14 +341,13 @@ try (Reader reader = new InputStreamRead // ... } } - </pre></div> + </code></pre> <p> You might find it handy to create something like this: </p> -<div class="source"> -<pre> +<pre><code> /** * Creates a reader capable of handling BOMs. * @@ -363,36 +360,34 @@ public InputStreamReader newReader(final .setPath(path) .get(), StandardCharsets.UTF_8); } - </pre></div> + </code></pre> </section> </section> - <section> -<h2><a name="Working_with_headers"></a>Working with headers</h2> + <section><a id="Working_with_headers"></a> +<h1>Working with headers</h1> Apache Commons CSV provides several ways to access record values. The simplest way is to access values by their index in the record. However, columns in CSV files often have a name, for example: ID, CustomerNo, Birthday, etc. The CSVFormat class provides an API for specifying these <i>header</i> names and CSVRecord on the other hand has methods to access values by their corresponding header name. - <section> -<h3><a name="Accessing_column_values_by_index"></a>Accessing column values by index</h3> + <section><a id="Accessing_column_values_by_index"></a> +<h2>Accessing column values by index</h2> To access a record value by index, no special configuration of the CSVFormat is necessary: -<div class="source"> -<pre>Reader in = new FileReader("path/to/file.csv"); +<pre><code>Reader in = new FileReader("path/to/file.csv"); Iterable<CSVRecord> records = CSVFormat.RFC4180.parse(in); for (CSVRecord record : records) { String columnOne = record.get(0); String columnTwo = record.get(1); } - </pre></div> + </code></pre> </section> - <section> -<h3><a name="Defining_a_header_manually"></a>Defining a header manually</h3> + <section><a id="Defining_a_header_manually"></a> +<h2>Defining a header manually</h2> Indices may not be the most intuitive way to access record values. For this reason it is possible to assign names to each column in the file: -<div class="source"> -<pre>Reader in = new FileReader("path/to/file.csv"); +<pre><code>Reader in = new FileReader("path/to/file.csv"); Iterable<CSVRecord> records = CSVFormat.RFC4180.builder() .setHeader("ID", "CustomerNo", "Name") .build() @@ -402,18 +397,17 @@ for (CSVRecord record : records) { String customerNo = record.get("CustomerNo"); String name = record.get("Name"); } - </pre></div> + </code></pre> Note that column values can still be accessed using their index. </section> - <section> -<h3><a name="Using_an_enum_to_define_a_header"></a>Using an enum to define a header</h3> + <section><a id="Using_an_enum_to_define_a_header"></a> +<h2>Using an enum to define a header</h2> Using String values all over the code to reference columns can be error prone. For this reason, it is possible to define an enum to specify header names. Note that the enum constant names are used to access column values. This may lead to enums constant names which do not follow the Java coding standard of defining constants in upper case with underscores: -<div class="source"> -<pre>public enum Headers { +<pre><code>public enum Headers { ID, CustomerNo, Name } Reader in = new FileReader("path/to/file.csv"); @@ -426,16 +420,15 @@ for (CSVRecord record : records) { String customerNo = record.get(Headers.CustomerNo); String name = record.get(Headers.Name); } - </pre></div> + </code></pre> Again it is possible to access values by their index and by using a String (for example "CustomerNo"). </section> - <section> -<h3><a name="Header_auto_detection"></a>Header auto detection</h3> + <section><a id="Header_auto_detection"></a> +<h2>Header auto detection</h2> Some CSV files define header names in their first record. If configured, Apache Commons CSV can parse the header names from the first record: -<div class="source"> -<pre>Reader in = new FileReader("path/to/file.csv"); +<pre><code>Reader in = new FileReader("path/to/file.csv"); Iterable<CSVRecord> records = CSVFormat.RFC4180.builder() .setHeader() .setSkipHeaderRecord(true) @@ -446,36 +439,34 @@ for (CSVRecord record : records) { String customerNo = record.get("CustomerNo"); String name = record.get("Name"); } - </pre></div> + </code></pre> This will use the values from the first record as header names and skip the first record when iterating. </section> - <section> -<h3><a name="Printing_with_headers"></a>Printing with headers</h3> + <section><a id="Printing_with_headers"></a> +<h2>Printing with headers</h2> <p> To print a CSV file with headers, you specify the headers in the format: </p> -<div class="source"> -<pre>final Appendable out = ...; +<pre><code>final Appendable out = ...; final CSVPrinter printer = CSVFormat.DEFAULT.builder() .setHeader("H1", "H2") .build() .print(out); - </pre></div> + </code></pre> <p> To print a CSV file with JDBC column labels, you specify the ResultSet in the format: </p> -<div class="source"> -<pre>try (final ResultSet resultSet = ...) { +<pre><code>try (final ResultSet resultSet = ...) { final CSVPrinter printer = CSVFormat.DEFAULT.builder() .setHeader(resultSet) .build() .print(out); } - </pre></div> + </code></pre> </section> </section> @@ -489,10 +480,7 @@ final CSVPrinter printer = CSVFormat.DEF <p>Copyright © 2005-2025 <a href="https://www.apache.org/";>The Apache Software Foundation</a>. All Rights Reserved.</p> - -<div class="center">Apache Commons, Apache Commons CSV, Apache, the Apache feather logo, and the Apache Commons project logos are trademarks of The Apache Software Foundation. - All other marks mentioned may be trademarks or registered trademarks of their respective owners.</div> - </div> + </div> </body> </html> \ No newline at end of file Modified: websites/production/commons/content/proper/commons-csv/xref-test/index.html ============================================================================== --- websites/production/commons/content/proper/commons-csv/xref-test/index.html (original) +++ websites/production/commons/content/proper/commons-csv/xref-test/index.html Sat Jan 11 14:23:31 2025 @@ -4,7 +4,7 @@ <!-- this is a JXR report set (jdk8) --> <head> <meta http-equiv="content-type" content="text/html; charset=UTF-8" /> - <title>Apache Commons CSV 1.13.0-SNAPSHOT Reference</title> + <title>Apache Commons CSV 1.13.0 Reference</title> <script type="text/javascript"> tmpTargetPage = "" + window.location.search; if (tmpTargetPage != "" && tmpTargetPage != "undefined") Modified: websites/production/commons/content/proper/commons-csv/xref-test/org/apache/commons/csv/CSVBenchmark.html ============================================================================== --- websites/production/commons/content/proper/commons-csv/xref-test/org/apache/commons/csv/CSVBenchmark.html (original) +++ websites/production/commons/content/proper/commons-csv/xref-test/org/apache/commons/csv/CSVBenchmark.html Sat Jan 11 14:23:31 2025 @@ -1,5 +1,5 @@ <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd";> -<html xmlns="http://www.w3.org/1999/xhtml"; xml:lang="en" lang="en"> +<html xmlns="http://www.w3.org/1999/xhtml"; xml:lang="" lang=""> <head><meta http-equiv="content-type" content="text/html; charset=UTF-8" /> <title>CSVBenchmark xref</title> <link type="text/css" rel="stylesheet" href="../../../../stylesheet.css" /> Modified: websites/production/commons/content/proper/commons-csv/xref-test/org/apache/commons/csv/CSVDuplicateHeaderTest.html ============================================================================== --- websites/production/commons/content/proper/commons-csv/xref-test/org/apache/commons/csv/CSVDuplicateHeaderTest.html (original) +++ websites/production/commons/content/proper/commons-csv/xref-test/org/apache/commons/csv/CSVDuplicateHeaderTest.html Sat Jan 11 14:23:31 2025 @@ -1,5 +1,5 @@ <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd";> -<html xmlns="http://www.w3.org/1999/xhtml"; xml:lang="en" lang="en"> +<html xmlns="http://www.w3.org/1999/xhtml"; xml:lang="" lang=""> <head><meta http-equiv="content-type" content="text/html; charset=UTF-8" /> <title>CSVDuplicateHeaderTest xref</title> <link type="text/css" rel="stylesheet" href="../../../../stylesheet.css" /> Modified: websites/production/commons/content/proper/commons-csv/xref-test/org/apache/commons/csv/CSVFileParserTest.html ============================================================================== --- websites/production/commons/content/proper/commons-csv/xref-test/org/apache/commons/csv/CSVFileParserTest.html (original) +++ websites/production/commons/content/proper/commons-csv/xref-test/org/apache/commons/csv/CSVFileParserTest.html Sat Jan 11 14:23:31 2025 @@ -1,5 +1,5 @@ <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd";> -<html xmlns="http://www.w3.org/1999/xhtml"; xml:lang="en" lang="en"> +<html xmlns="http://www.w3.org/1999/xhtml"; xml:lang="" lang=""> <head><meta http-equiv="content-type" content="text/html; charset=UTF-8" /> <title>CSVFileParserTest xref</title> <link type="text/css" rel="stylesheet" href="../../../../stylesheet.css" /> Modified: websites/production/commons/content/proper/commons-csv/xref-test/org/apache/commons/csv/CSVFormatPredefinedTest.html ============================================================================== --- websites/production/commons/content/proper/commons-csv/xref-test/org/apache/commons/csv/CSVFormatPredefinedTest.html (original) +++ websites/production/commons/content/proper/commons-csv/xref-test/org/apache/commons/csv/CSVFormatPredefinedTest.html Sat Jan 11 14:23:31 2025 @@ -1,5 +1,5 @@ <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd";> -<html xmlns="http://www.w3.org/1999/xhtml"; xml:lang="en" lang="en"> +<html xmlns="http://www.w3.org/1999/xhtml"; xml:lang="" lang=""> <head><meta http-equiv="content-type" content="text/html; charset=UTF-8" /> <title>CSVFormatPredefinedTest xref</title> <link type="text/css" rel="stylesheet" href="../../../../stylesheet.css" /> Modified: websites/production/commons/content/proper/commons-csv/xref-test/org/apache/commons/csv/CSVFormatTest.html ============================================================================== --- websites/production/commons/content/proper/commons-csv/xref-test/org/apache/commons/csv/CSVFormatTest.html (original) +++ websites/production/commons/content/proper/commons-csv/xref-test/org/apache/commons/csv/CSVFormatTest.html Sat Jan 11 14:23:31 2025 @@ -1,5 +1,5 @@ <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd";> -<html xmlns="http://www.w3.org/1999/xhtml"; xml:lang="en" lang="en"> +<html xmlns="http://www.w3.org/1999/xhtml"; xml:lang="" lang=""> <head><meta http-equiv="content-type" content="text/html; charset=UTF-8" /> <title>CSVFormatTest xref</title> <link type="text/css" rel="stylesheet" href="../../../../stylesheet.css" /> Modified: websites/production/commons/content/proper/commons-csv/xref-test/org/apache/commons/csv/CSVParserTest.html ============================================================================== --- websites/production/commons/content/proper/commons-csv/xref-test/org/apache/commons/csv/CSVParserTest.html (original) +++ websites/production/commons/content/proper/commons-csv/xref-test/org/apache/commons/csv/CSVParserTest.html Sat Jan 11 14:23:31 2025 @@ -1,5 +1,5 @@ <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd";> -<html xmlns="http://www.w3.org/1999/xhtml"; xml:lang="en" lang="en"> +<html xmlns="http://www.w3.org/1999/xhtml"; xml:lang="" lang=""> <head><meta http-equiv="content-type" content="text/html; charset=UTF-8" /> <title>CSVParserTest xref</title> <link type="text/css" rel="stylesheet" href="../../../../stylesheet.css" /> @@ -905,7 +905,7 @@ <a class="jxr_linenumber" name="L897" href="#L897">897</a> .setDelimiter(',') <a class="jxr_linenumber" name="L898" href="#L898">898</a> .setQuote('\'') <a class="jxr_linenumber" name="L899" href="#L899">899</a> .get(); -<a class="jxr_linenumber" name="L900" href="#L900">900</a> <strong class="jxr_keyword">try</strong> (CSVParser parser = CSVParser.builder().setReader(<strong class="jxr_keyword">new</strong> StringReader(code)).setFormat(format).setCharset(UTF_8).setTrackBytes(<strong class="jxr_keyword">true</strong>).get() ) { +<a class="jxr_linenumber" name="L900" href="#L900">900</a> <strong class="jxr_keyword">try</strong> (CSVParser parser = CSVParser.builder().setReader(<strong class="jxr_keyword">new</strong> StringReader(code)).setFormat(format).setCharset(UTF_8).setTrackBytes(<strong class="jxr_keyword">true</strong>).get()) { <a class="jxr_linenumber" name="L901" href="#L901">901</a> CSVRecord record = <strong class="jxr_keyword">new</strong> CSVRecord(parser, <strong class="jxr_keyword">null</strong>, <strong class="jxr_keyword">null</strong>, 1L, 0L, 0L); <a class="jxr_linenumber" name="L902" href="#L902">902</a> <a class="jxr_linenumber" name="L903" href="#L903">903</a> assertEquals(0, parser.getRecordNumber()); Modified: websites/production/commons/content/proper/commons-csv/xref-test/org/apache/commons/csv/CSVPrinterTest.html ============================================================================== --- websites/production/commons/content/proper/commons-csv/xref-test/org/apache/commons/csv/CSVPrinterTest.html (original) +++ websites/production/commons/content/proper/commons-csv/xref-test/org/apache/commons/csv/CSVPrinterTest.html Sat Jan 11 14:23:31 2025 @@ -1,5 +1,5 @@ <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd";> -<html xmlns="http://www.w3.org/1999/xhtml"; xml:lang="en" lang="en"> +<html xmlns="http://www.w3.org/1999/xhtml"; xml:lang="" lang=""> <head><meta http-equiv="content-type" content="text/html; charset=UTF-8" /> <title>CSVPrinterTest xref</title> <link type="text/css" rel="stylesheet" href="../../../../stylesheet.css" />
![https://people.apache.org/~ggregory/img/garydgregory80.png"](https://people.apache.org/~ggregory/img/garydgregory80.png"){kind=link}