-- Hoogle documentation, generated by Haddock
-- See Hoogle, http://www.haskell.org/hoogle/


-- | Read and write spreadsheets from and to CSV files in a lazy way
--   
--   Read and write spreadsheets from and to files containing comma
--   separated values (CSV) in a lazy way. See also the csv package
--   <a>http://hackage.haskell.org/package/csv</a> and
--   <a>http://www.xoltar.org/languages/haskell.html</a>,
--   <a>http://www.xoltar.org/languages/haskell/CSV.hs</a>. Both do not
--   parse lazy. Reading from other source than plain <a>String</a>s could
--   be easily added.
@package spreadsheet
@version 0.1.2

module Data.Spreadsheet

-- | A spreadsheet is a list of lines, each line consists of cells, and
--   each cell is a string. Ideally, spreadsheets read from a CSV file have
--   lines with the same number of cells per line. However, we cannot
--   assert this, and thus we parse the lines as they come in.
type T = [[String]]

-- | <tt>fromString qm sep text</tt> parses <tt>text</tt> into a
--   spreadsheet, using the quotation character <tt>qm</tt> and the
--   separator character <tt>sep</tt>.
fromString :: Char -> Char -> String -> Exceptional UserMessage T

-- | <tt>fromString qm sep text</tt> parses <tt>text</tt> into a
--   spreadsheet and additionally returns text that follows after CSV
--   formatted data.
fromStringWithRemainder :: Char -> Char -> String -> Exceptional UserMessage (T, String)

-- | This is a quick hack. It does neither handle field nor line separators
--   within quoted fields. You must provide well-formed CSV content without
--   field and line separators within quotations. Everything else yields an
--   error.
fromStringSimple :: Char -> Char -> String -> T
type UserMessage = String
toString :: Char -> Char -> T -> String
toStringSimple :: Char -> Char -> T -> String