eN      !"#$%&'()*+,-./0123456789:;<=>?@ABCDEFGHIJKLM experimental#Janne Hellsten <jjhellst@gmail.com> Safe-Inferred<a way to reify a list of exceptions into a single exception NTwo  4 cases are considered equal, regardless of what the " list of exceptions looks like.  OPQRSN   OPQRSNportable experimental#Janne Hellsten <jjhellst@gmail.com>None5A Field represents metadata about a particular field  Connection to an open database.      portable experimental#Janne Hellsten <jjhellst@gmail.com>None>A composite type to parse your custom data structures without 5 having to define dummy newtype wrappers every time.  # instance FromRow MyData where ...  $ instance FromRow MyData2 where ... &then I can do the following for free:   res <- query' c ...  forM res $ \"(MyData{..} :. MyData2{..}) -> do  .... A single-value " collection". AThis is useful if you need to supply a single parameter to a SQL 6 query, or extract a single column from a SQL result. Parameter example:  query c " select x from scores where x > ?" ( (42::Int))Result example: xs < - query_ c "select id from users"  forM_ xs $ \( id) -> {- ... -}>A query string. This type is intended to make it difficult to E construct a SQL query by concatenating string fragments, as that is A an extremely common way to accidentally introduce SQL injection & vulnerabilities into an application. This type is an instance of T, so the easiest way to $ construct a query is to enable the OverloadedStrings language = extension and then simply write the query in double quotes.  $ {-# LANGUAGE OverloadedStrings #-}   import Database.SQLite.Simple   q :: Query  q = "select ?" The underlying type is a Text#, and literal Haskell strings that D contain Unicode characters will be correctly transformed to UTF-8. A placeholder for the SQL NULL value.  !UVWXY  ! !  !UVWXYportable experimental#Janne Hellsten <jjhellst@gmail.com>None".A type that may be converted from a SQL type. #(Convert a SQL value to a Haskell value. FReturns a list of exceptions if the conversion fails. In the case of 3 library instances, this will usually be a single %, but  may be a UnicodeException. Implementations of #% should not retain any references to  the  nor the Z arguments after the result has = been evaluated to WHNF. Such a reference causes the entire  LibPQ.   to be retained. For example, the instance for Z uses [ to avoid @ such a reference, and that using bytestring functions such as \  and ]+ alone will also trigger this memory leak. %=Exception thrown if conversion from a SQL value to a Haskell  value fails. &0The SQL value could not be parsed, or could not 0 be represented as a valid Haskell value, or an 4 unexpected low-level error occurred (e.g. mismatch - between metadata and actual data in a row). 'A SQL NULL" was encountered when the Haskell  type did not permit it. (.The SQL and Haskell types are not compatible. ,>Return the actual SQL data for a database field. This allows  user-defined "" instances to access the SQL data ' associated with a field being parsed. -#Given one of the constructors from %, the field,  and an +), this fills in the other fields in the ' exception value and returns it in a 'Left . SomeException'  constructor. "#$%&'()*+^_`,-abcdefghijklmno "#$%&'()*+,-"#$%('&)*+)*+)*+,-"#$% ('&)*+)*+)*+^_`,-abcdefghijklmnoportable experimental#Janne Hellsten <jjhellst@gmail.com>None.CA collection type that can be converted from a sequence of fields. N Instances are provided for tuples up to 10 elements and lists of any length. DNote that instances can defined outside of sqlite-simple, which is " often useful. For example, here''s an instance for a user-defined pair:  6data User = User { name :: String, fileQuota :: Int }   instance . User where  fromRow = User <$> 1 <*> 1 The number of calls to 1* must match the number of fields returned 5 in a single row of the query result. Otherwise, a &  exception will be thrown. ANote the caveats associated with user-defined implementations of  /. ./01p2qrstuvwxyz{| ./012./ 102./01p2qrstuvwxyz{|portable experimental#Janne Hellsten <jjhellst@gmail.com>None3>A type that may be used as a single parameter to a SQL query. 46Prepare a value for substitution into a query string. 34}~343434}~portable experimental#Janne Hellsten <jjhellst@gmail.com>None5<A collection type that can be turned into a list of SQLData  elements. 6 ToField a collection of values. 56565656portable experimental#Janne Hellsten <jjhellst@gmail.com>None7Exception thrown if a  was malformed. ! This may occur if the number of '?' characters in the query : string does not match the number of parameters provided. ;An SQLite prepared statement. <;Open a database connection to a given file. Will throw an ! exception if it cannot connect. Every < must be closed with a call to =. If you specify ":memory:"+ or an empty string as the input filename, A then a private, temporary in-memory database is created for the ; connection. This database will vanish when you close the  connection. =Close a database connection. >KOpens a database connection, executes an action using this connection, and < closes the connection, even in the presence of exceptions. ? (http://www.sqlite.org/c3ref/profile.html Enable/;disable tracing of SQL execution. Tracing can be disabled  by setting  as the logger callback. @Warning: If the logger callback throws an exception, your whole 0 program may crash. Enable only for debugging! @/Binds parameters to a prepared statement. Once L returns , & the statement must be reset with the A function before it can be  executed again by calling L. AFResets a statement. This does not reset bound parameters, if any, but 9 allows the statement to be reexecuted again by invoking L. BKBinds parameters to a prepared statement and then resets them, even in the  presence of exceptions. CLOpens a prepared statement. A prepared statement must always be closed with  a corresponding call to D$ before closing the connection. Use  L) to iterate on the values returned. Once L returns  , you need to invoke A( before reexecuting the statement again  with L. DCloses a prepared statement. EIOpens a prepared statement, executes an action using this statement, and ; closes the statement, even in the presence of exceptions. F Execute an INSERT, UPDATE!, or other SQL query that is not  expected to return results. Throws 70 if the query could not be formatted correctly. G Perform a SELECT/ or other SQL query that is expected to return > results. All results are retrieved and converted before this  function returns. CWhen processing large results, this function will consume a lot of % client-side memory. Consider using J instead. Exceptions that may be thrown:  74: the query string mismatched with given arguments.  %: result conversion failed. H A version of G+ that does not perform query substitution. I A version of F+ that does not perform query substitution. J Perform a SELECT8 or other SQL query that is expected to return results. ( Results are converted and fed into the action callback as they are being  retrieved from the database. JThis allows gives the possibility of processing results in constant space & (for instance writing them to disk). Exceptions that may be thrown:  74: the query string mismatched with given arguments.  %: result conversion failed. K A version of J0 which does not perform parameter substitution. L3Extracts the next row from the prepared statement. M>Returns the rowid of the most recent successful INSERT on the  given database connection.  See also  2http://www.sqlite.org/c3ref/last_insert_rowid.html. 789:;<=>?@ABCDEFGHIJKLM/%)*+./156789:;<=>?@ABCDEFGHIJKLM556./;<=>?GHMFI1JKCDE@ABL789:%)*+)*+)*+789:;<=>?@ABCDEFGHIJKLM        !!"##$%%&'()*+,-./0123456789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]^_`ab`cd`ce`fghijklmnopqrstuvwxyz{|}~X;?sqlite-simple-0.4.0.0Database.SQLite.SimpleDatabase.SQLite.Simple.OkDatabase.SQLite.Simple.InternalDatabase.SQLite.Simple.Types Database.SQLite.Simple.FromFieldDatabase.SQLite.Simple.FromRowDatabase.SQLite.Simple.ToFieldDatabase.SQLite.Simple.ToRowPQResultdirect-sqlite-2.3.3Database.SQLite3 SQLIntegerSQLFloatSQLTextSQLBlobSQLNullSQLData ManyErrorsOkErrors RowParserRPunRPRow rowresultFieldresultcolumn Connection gettypename:.OnlyfromOnlyQuery fromQueryNull FromField fromField FieldParser ResultErrorConversionFailedUnexpectedNull Incompatible errSQLTypeerrHaskellType errMessage fieldData returnErrorFromRowfromRow fieldWithfieldnumFieldsRemainingToFieldtoFieldToRowtoRow FormatError fmtMessagefmtQuery fmtParams StatementopenclosewithConnectionsetTracebindresetwithBind openStatementcloseStatement withStatementexecutequeryquery_execute_foldfold_nextRowlastInsertRowId$fEqOk$fExceptionManyErrors $fMonadOk $fMonadPlusOk$fAlternativeOk$fApplicativeOkbase Data.StringIsString $fMonoidQuery$fIsStringQuery $fReadQuery $fShowQuery$fEqNullbytestring-0.10.0.0Data.ByteString.Internal ByteStringData.ByteStringcopydropData.ByteString.Char8 takeWhilelefttakeInt fieldTypename$fFromFieldDay$fFromFieldUTCTime$fFromFieldByteString $fFromField[]$fFromFieldText$fFromFieldBool$fFromFieldDouble$fFromFieldInteger$fFromFieldInt64$fFromFieldInt$fFromFieldInt32$fFromFieldInt16$fFromFieldNull$fFromFieldMaybe$fExceptionResultErrorellipsis $fFromRow:. $fFromRow[]$fFromRow(,,,,,,,,,)$fFromRow(,,,,,,,,)$fFromRow(,,,,,,,)$fFromRow(,,,,,,)$fFromRow(,,,,,)$fFromRow(,,,,)$fFromRow(,,,) $fFromRow(,,) $fFromRow(,) $fFromRowOnly $fToFieldDay$fToFieldUTCTime $fToFieldText $fToField[]$fToFieldText0$fToFieldByteString$fToFieldByteString0$fToFieldDouble$fToFieldFloat$fToFieldWord64 $fToFieldWord$fToFieldWord32$fToFieldWord16$fToFieldWord8$fToFieldInteger$fToFieldInt64 $fToFieldInt$fToFieldInt32$fToFieldInt16 $fToFieldInt8 $fToFieldBool $fToFieldNull$fToFieldMaybe$fToFieldSQLData $fToRow:. $fToRow[]$fToRow(,,,,,,,,,)$fToRow(,,,,,,,,)$fToRow(,,,,,,,)$fToRow(,,,,,,)$fToRow(,,,,,) $fToRow(,,,,) $fToRow(,,,) $fToRow(,,) $fToRow(,) $fToRowOnly $fToRow() Data.MaybeNothingwithStatementP doFoldToListdoFold convertRowfmtErrorgetQuery$fExceptionFormatError