urlencoded-0.4.0: Generate or process x-www-urlencoded data

Safe HaskellNone




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


Representation of a URL-encoded string

filter :: ((String, String) -> Bool) -> URLEncoded -> URLEncodedSource

Create a URLEncoded object that represents all pairs from the input that match the supplied predicate

class URLShow a whereSource

Serialize a value into a String for encoding as part of an x-www-urlencoded value


urlShow :: a -> StringSource

class URLEncode a whereSource

Encode a value as x-www-urlencoded



empty :: URLEncodedSource

URLEncoded data with no pairs

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

Parse this string as x-www-urlencoded

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

Import this list of pairs as URLEncoded data

(%=) :: (URLShow a, URLShow b) => a -> b -> URLEncodedSource

Create singleton URLEncoded data containing the supplied key and value



:: (URLShow a, URLShow b) 
=> a


-> Maybe b


-> URLEncoded 

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

(%&) :: (URLEncode q1, URLEncode q2) => q1 -> q2 -> URLEncodedSource

class AddURLEncoded a whereSource


(%?) :: URLEncode args => a -> args -> aSource


null :: URLEncoded -> BoolSource

Is this URLEncoded data empty?

keys :: URLEncoded -> [String]Source

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

lookupAll :: URLShow a => a -> URLEncoded -> [String]Source

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 :: (URLShow a, MonadError e m) => a -> URLEncoded -> m StringSource

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

(%!) :: URLShow a => URLEncoded -> a -> Maybe StringSource

Look up a key in a URLEncoded value and return the first matching value, or Nothing if there is no value that matches


addToURI :: URLEncoded -> URI -> URISource

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

export :: URLEncoded -> StringSource

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)