<action issue="CSV-119" type="add" dev="ggregory" due-to="Sergei Lebedev">CSVFormat is missing a print(...) method</action>

garydgregory · garydgregory · commit 65f110ec14b9 · 2014-06-02T18:04:49.000Z
git-svn-id: https://svn.apache.org/repos/asf/commons/proper/csv/trunk@1599285 13f79535-47bb-0310-9956-ffa450edef68
diff --git a/src/changes/changes.xml b/src/changes/changes.xml
@@ -40,6 +40,7 @@
   <body>
 
     <release version="1.0" date="TBD" description="First release">
+      <action issue="CSV-119" type="add" dev="ggregory" due-to="Sergei Lebedev">CSVFormat is missing a print(...) method</action>
       <action issue="CSV-118" type="fix" dev="ggregory" due-to="Enrique Lara">CSVRecord.toMap() throws NPE on formats with no
         headers.</action>
       <action issue="CSV-113" type="fix" dev="sebb">Check whether ISE/IAE are being used appropriately</action>
diff --git a/src/main/java/org/apache/commons/csv/CSVFormat.java b/src/main/java/org/apache/commons/csv/CSVFormat.java
@@ -595,6 +595,21 @@ public CSVParser parse(final Reader in) throws IOException {
         return new CSVParser(in, this);
     }
 
+    /**
+     * Prints to the specified output.
+     * 
+     * <p>
+     * See also {@link CSVPrinter}.
+     * </p>
+     * 
+     * @param out
+     *        the output
+     * @return a printer to an output
+     */
+    public CSVPrinter print(final Appendable out) {
+        return new CSVPrinter(out, this);
+    }
+
     @Override
     public String toString() {
         final StringBuilder sb = new StringBuilder();
diff --git a/src/test/java/org/apache/commons/csv/CSVPrinterTest.java b/src/test/java/org/apache/commons/csv/CSVPrinterTest.java
@@ -303,6 +303,15 @@ public void testPrinter7() throws IOException {
         printer.close();
     }
 
+    @Test
+    public void testPrint() throws IOException {
+        final StringWriter sw = new StringWriter();
+        final CSVPrinter printer = CSVFormat.DEFAULT.print(sw);
+        printer.printRecord("a", "b\\c");
+        assertEquals("a,b\\c" + recordSeparator, sw.toString());
+        printer.close();
+    }
+
     @Test
     public void testPrintNullValues() throws IOException {
         final StringWriter sw = new StringWriter();
