Useful.List

List operations, part of the Useful module.

Documentation

explodeI :: Eq a => [a] -> a -> [[a]]

Takes a list item and splits a list around it, removing the item.

 $ explodeI "Hello there people" ' '
 ["Hello","there","people"]

splitI :: Eq a => [a] -> a -> [[a]]

Alias of explodeI

implodeI :: Eq a => [a] -> a -> [a]

Take a list item and concatinates each element of it around another given item.

 $implodeI "askjdnaskd" '!'
 "a!s!k!j!d!n!a!s!k!d"

joinI :: Eq a => [a] -> a -> [a]

alias of implodeI

explode :: Eq a => [a] -> [a] -> [[a]]

Takes a two lists and explodes the first into a new list, around the second. Removing the second list where it occurs.

 $explode "hello there people" "ll"
 ["he","o there people"]
 $explode "hello there people" " "
 ["hello","there","people"]

split :: Eq a => [a] -> [a] -> [[a]]

alias of explode

implode :: Eq a => [[a]] -> [a] -> [a]

Takes a list of lists and an extra list and concatinates the list of lists with the second list inbetween. When used with the empty list mimics concat

 $ implode ["helloasdad","asd hello","hello"] "!!"
 "helloasdad!!asd hello!!hello"

join :: Eq a => [[a]] -> [a] -> [a]

Alias of implode

rmEmpty :: Eq a => [[a]] -> [[a]]

In a list of lists this removes any occurances of the empty list. Can also be used to remove occurances of the empty string.

 $rmEmpty ["hello","","there","","people",""]
 ["hello","there","people"]

map2 :: (a -> b) -> [[a]] -> [[b]]

maps a function in depth N to the given list. map3, map4, map5 are also defined.

 $ map2 (*2) [[1,2,3,4],[1,1,1,2]]
 [[2,4,6,8],[2,2,2,4]]

map3 :: (a -> b) -> [[[a]]] -> [[[b]]]

map4 :: (a -> b) -> [[[[a]]]] -> [[[[b]]]]

map5 :: (a -> b) -> [[[[[a]]]]] -> [[[[[b]]]]]

replace :: Eq a => [a] -> [a] -> [a] -> [a]

Replaces any occurrences of the second list, with the third list, in the first list.

 $ replace "why hello hello there" "hello" "bonjour"
 "why bonjour bonjour there"

each :: [a] -> [[a]]

Takes a list of items and returns a list with each element in it's own single list.

 $ each "hello"
 ["h","e","l","l","o"]