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


-- | Generate or process x-www-urlencoded data
--   
--   Generate or process x-www-urlencoded data as it appears in HTTP or
--   HTTPS URIs and HTTP POSTs. See
--   <a>http://www.w3.org/TR/html401/interact/forms.html#h-17.13.4.1</a>
@package urlencoded
@version 0.0


-- | Implements a data type for constructing and destructing
--   x-www-urlencoded strings. See
--   <a>http://www.w3.org/TR/html401/interact/forms.html#h-17.13.4.1</a>
module Data.URLEncoded

-- | A container for URLEncoded data
data URLEncoded

-- | URLEncoded data with no pairs
empty :: URLEncoded

-- | Parse this string as x-www-urlencoded
importString :: (MonadError e m) => String -> m URLEncoded

-- | Import this list of pairs as URLEncoded data
importList :: [(String, String)] -> URLEncoded

-- | Create singleton URLEncoded data containing the supplied key and value
(%=) :: String -> String -> URLEncoded

-- | If the second value is Nothing, return empty URLEncoded data.
--   Otherwise return singleton URLEncoded data that contains the given key
--   and value.
(%=?) :: String -> Maybe String -> URLEncoded

-- | Is this URLEncoded data empty?
null :: URLEncoded -> Bool

-- | All of the keys from the URLEncoded value, in order, preserving
--   duplicates
keys :: URLEncoded -> [String]

-- | Return all values whose keys match the supplied key, in the order they
--   appear in the query. Will return an empty list if no keys match.
lookup :: String -> URLEncoded -> [String]

-- | Return the <i>first</i> value for the given key, or throw an error if
--   the key is not present in the URLEncoded data.
lookup1 :: (MonadError e m) => String -> URLEncoded -> m String
pairs :: URLEncoded -> [(String, String)]

-- | Add this URL-encoded data to the query part of a URI, after any
--   existing query arguments.
addToURI :: URLEncoded -> URI -> URI

-- | Convert this URLEncoded object into an x-www-urlencoded String (The
--   resulting string is 7-bit clean ASCII, containing only unreserved URI
--   characters and %-encoded values)
export :: URLEncoded -> String
instance Monoid URLEncoded
instance Eq URLEncoded
instance Show URLEncoded