úÎtĪl|E      !"#$%&'()*+,-./0123456789:;<=>?@ABCD experimental#Janne Hellsten <jjhellst@gmail.com> Safe-Inferred<a way to reify a list of exceptions into a single exception ETwo  4 cases are considered equal, regardless of what the " list of exceptions looks like.  FGHIJE   FGHIJEportable 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 K, 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.PostgreSQL.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.  !"LMNOP  !" !"   !"LMNOPportable 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 Q arguments after the result has = been evaluated to WHNF. Such a reference causes the entire  LibPQ.   to be retained. For example, the instance for Q uses R to avoid @ such a reference, and that using bytestring functions such as S  and T+ 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. #$%&'()*+,UVW-.XYZ[\]^_`abcde #$%&'()*+,-.#$%&)('*+,*+,*+,-.#$%& )('*+,*+,*+,UVW-.XYZ[\]^_`abcdeportable 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 <$> 2 <*> 2 The number of calls to 2* 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  0. /012f3ghijklmnopqr /0123/0 213/012f3ghijklmnopqrportable experimental#Janne Hellsten <jjhellst@gmail.com>None4>A type that may be used as a single parameter to a SQL query. 56Prepare a value for substitution into a query string. 45stuvwxyz{|}~€‚ƒ„…†‡ˆ‰Š454545stuvwxyz{|}~€‚ƒ„…†‡ˆ‰Športable experimental#Janne Hellsten <jjhellst@gmail.com>None6<A collection type that can be turned into a list of SQLData  elements. 7 ToField a collection of values. 67‹ŒŽ‘’“”•–—676767‹ŒŽ‘’“”•–—portable experimental#Janne Hellsten <jjhellst@gmail.com>None 8Exception 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. <;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. ? Execute an INSERT, UPDATE!, or other SQL query that is not  expected to return results. Throws 80 if the query could not be formatted correctly. @ 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 C instead. Exceptions that may be thrown:  84: the query string mismatched with given arguments.  &: result conversion failed. A A version of @+ that does not perform query substitution. B A version of ?+ that does not perform query substitution. C 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:  84: the query string mismatched with given arguments.  &: result conversion failed. D A version of C0 which does not perform parameter substitution. 8˜9:;<=>™š?›@ABCDœžŸ% &*+,/026789:;<=>?@ABCD+ 67/0<=>@A?B2CD89:;&*+,*+,*+,8˜9:;<=>™š?›@ABCDœžŸ        !!""#$$%&&'()*+,-./0123456789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYWZ[WZ\W]^_`abcdefghijklmnopqrstuvwxyz{|}~€‚ƒ„…†‡ˆ‰Š‹ŒŽ‘’“”•–—˜™š›œžŸ Ą<ĒĢĪĨĶ§ĻĐsqlite-simple-0.3.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.3Database.SQLite3 SQLIntegerSQLFloatSQLTextSQLBlobSQLNullSQLData ManyErrorsOkErrors RowParserRPunRPRowrow rowresultFieldresultcolumn Connection gettypename:.OnlyfromOnlyQuery fromQueryNull FromField fromField FieldParser ResultErrorConversionFailedUnexpectedNull Incompatible errSQLTypeerrHaskellType errMessage fieldData returnErrorFromRowfromRow fieldWithfieldnumFieldsRemainingToFieldtoFieldToRowtoRow FormatError fmtMessagefmtQuery fmtParamsopenclosewithConnectionexecutequeryquery_execute_foldfold_$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$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()withBind withStatement doFoldToListdoFold convertRowfmtError$fExceptionFormatError