lines 6-48 of file: cpp/lib/csv_write.cpp

{xrst_begin csv_write}
{xrst_spell
   newlines
   th
}

Write a Csv File
################

Prototype
*********
{xrst_literal
   // BEGIN PROTOTYPE
   // END PROTOTYPE
}

vec_vec_str
***********
see :ref:`vec_vec_str-name` .

file_name
*********
is the name of the csv file.
The rows in this file are separated by newlines ``'\n'``
and the columns are separated by commas ``','`` .
There are no other special characters in this file.

csv_table
*********
#. The *j*-th column of the *i*-th row of the file contains the value
   csv_table[i][j] .
#. 0 < csv_table[i].size() for all row indices *i* .
#. The character ``','`` is added between columns.
#. The character ``'\n'`` is added at the end of every line.

{xrst_toc_hidden
   cpp/xam/csv_write.cpp
}
Example
*******
:ref:`xam_csv_write.cpp-name` contains an example and test of this routine.

{xrst_end csv_write}