Update of /cvsroot/q-lang/q-csv
In directory sc8-pr-cvs16.sourceforge.net:/tmp/cvs-serv509
Modified Files:
README
Log Message:
elaborate on different kinds of available interface functions
Index: README
===================================================================
RCS file: /cvsroot/q-lang/q-csv/README,v
retrieving revision 1.5
retrieving revision 1.6
diff -C2 -d -r1.5 -r1.6
*** README 10 Jan 2008 23:14:46 -0000 1.5
--- README 10 Jan 2008 23:41:21 -0000 1.6
***************
*** 8,12 ****
that allow field delimiters and quote delimiters to be changed.
! Two variants of reading and writing are available:
- freadcsv_data converts non-quoted numeric fields to integer or double values
--- 8,29 ----
that allow field delimiters and quote delimiters to be changed.
! INSTALLATION
!
! This module is (or will soon be) included in the binary "all in one" packages
! available from the Q website. Use these if you can. To install from the
! sources, run 'make' to compile the module and 'make install' (as root) to
! install it under the default prefix (/usr/local). If your Q installation lives
! elsewhere (e.g., under /usr), you can specify the installation prefix as
! follows: 'make prefix=/usr install'. (It is recommended to install the module
! under the same prefix as the Q interpreter so that the interpreter can find
! the module. Otherwise you might have to modify your QPATH accordingly.)
!
! USAGE
!
! Data records are represented as tuples of strings and numeric data. Two
! variants of reading and writing are available. Basically, the functions whose
! names end in _data will convert numeric (integer and floating point) values
! automatically, while the _string variants will treat them as ordinary (string)
! data. More precisely:
- freadcsv_data converts non-quoted numeric fields to integer or double values
***************
*** 19,34 ****
fwritecsv_string writes all values as quoted fields.
! INSTALLATION
! This module is (or will soon be) included in the binary "all in one" packages
! available from the Q website. Use these if you can.
! To install from the sources, run 'make' to compile the module and 'make
! install' (as root) to install it under the default prefix (/usr/local). If
! your Q installation lives elsewhere (e.g., under /usr), you can specify the
! installation prefix as follows: 'make prefix=/usr install'. (It is recommended
! to install the module under the same prefix as the Q interpreter so that the
! interpreter finds the module. Otherwise you might have to modify your QPATH
! accordingly.)
NOTES
--- 36,51 ----
fwritecsv_string writes all values as quoted fields.
! The primary interface functions freadcsv and fwritecsv are defined to be
! equivalent to the _data variants by default. If necessary, you can change this
! by adding appropriate definitions to your program, i.e.:
! freadcsv = freadcsv_string;
! fwritecsv = fwritecsv_string;
! The routines described above read/write one record at a time. Additional
! functions (freadfilecsv and fwritefilecsv, again with corresponding _data and
! _string variants) are provided to convert between entire CSV files and lists
! of tuples. Note that these require that the entire data fits into RAM and will
! thus be inefficient for huge datasets.
NOTES
|
