| MissingH-1.1.0.3: Large utility library | Contents | Index
Data.CSV |
Portability | portable
Stability | provisional
Maintainer | John Goerzen <jgoerzen@complete.org>
Description
Haskell Parsec parsers for comma-separated value (CSV) files. Written by John Goerzen, jgoerzen@complete.org
Synopsis
csvFile :: CharParser st [[String]]
genCsvFile :: [[String]] -> String
Documentation
csvFile :: CharParser st [[String]]
Parse a Comma-Separated Value (CSV) file. The return value is a list of lines; each line is a list of cells; and each cell is a String. Please note that CSV files may have a different number of cells on each line. Also, it is impossible to distinguish a CSV line that has a call with no data from a CSV line that has no cells. Here are some examples:
    Input (literal strings)          Parses As (Haskell String syntax)
    -------------------------------- ---------------------------------
    1,2,3                            [["1", "2", "3"]]

    l1                               [["l1"], ["l2"]]
    l2

     (empty line)                    [[""]]

    NQ,"Quoted"                      [["NQ", "Quoted"]]

    NQ,"Embedded""Quote"             [["NQ", "Embedded\"Quote"]]
To parse a String, you might use:
    import Text.ParserCombinators.Parsec
    import Data.String.CSV
    ....
    parse csvFile "" mystring
To parse a file, you might instead use:
    do result <- parseFromFile csvFile "/path/to/file"
Please note that the result of parsing will be of type (Either ParseError [[String]]). A Left result indicates an error. For more details, see the Parsec information.
genCsvFile :: [[String]] -> String
Generate CSV data for a file. The resulting string can be written out to disk directly.
Produced by Haddock version 2.7.2