Data.URLEncoded

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

Representation of a URL-encoded string

data URLEncoded

A container for URLEncoded data

Instances

Eq URLEncoded

Show URLEncoded

Monoid URLEncoded

Generate

empty :: URLEncoded

URLEncoded data with no pairs

importString :: MonadError e m => String -> m URLEncoded

Parse this string as x-www-urlencoded

importList :: [(String, String)] -> URLEncoded

Import this list of pairs as URLEncoded data

(%=) :: String -> String -> URLEncoded

Create singleton URLEncoded data containing the supplied key and value

(%=?)

Arguments

:: String

key

-> Maybe String

value

-> URLEncoded

If the second value is Nothing, return empty URLEncoded data. Otherwise return singleton URLEncoded data that contains the given key and value.

Query

null :: URLEncoded -> Bool

Is this URLEncoded data empty?

keys :: URLEncoded -> [String]

All of the keys from the URLEncoded value, in order, preserving duplicates

lookup :: String -> 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.

lookup1 :: MonadError e m => String -> URLEncoded -> m String

Return the first value for the given key, or throw an error if the key is not present in the URLEncoded data.

pairs :: URLEncoded -> [(String, String)]

Export

addToURI :: URLEncoded -> URI -> URI

Add this URL-encoded data to the query part of a URI, after any existing query arguments.

export :: URLEncoded -> String

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)