Generics.Putlenses.Examples.Examples

Collection of miscellaneous put-based programming examples.

Lists

unzipPut :: (Monad m, Eq a, Eq b) => PutlensM m ([a], [b]) [(a, b)]

Unzips a list into two lists (creating empty tail lists by default)

mapPut :: Monad m => PutlensM m b a -> PutlensM m [b] [a]

Putlens version of map

unfoldrPut :: (Monad m, Eq a, Eq b) => PutlensM m (b, a) a -> a -> PutlensM m [b] a

Putlens version of foldr

foldrPut :: Monad m => PutlensM m b (Either () (a, b)) -> PutlensM m b [a]

Putlens version of unfoldr

mfilterPut :: MonadPlus m => (s -> Bool) -> PutlensM m s v -> PutlensM m s v

Putlens version of mfilter

unfoldrsPut :: (Monad m, Eq a, Eq b) => PutlensM m (b, a) a -> a -> PutlensM m [b] a

Variant of unfoldrPut that tries to present the original source branching even when the view value matches the stop condition Useful for example for cases when we want to always preserve the length of the original source list.

Constructor/destructor putlenses for lists

nilPut :: Monad m => PutlensM m [a] ()

consPut :: Monad m => PutlensM m [a] (a, [a])

unnilPut :: Monad m => PutlensM m () [a]

unconsPut :: Monad m => PutlensM m (a, [a]) [a]

unheadPut :: (Monad m, Eq a) => PutlensM m [a] a

untailPut :: (Monad m, Eq a) => PutlensM m [a] [a]

wrapPut :: (Monad m, Eq a) => PutlensM m [a] a

unwrapPut :: (Monad m, Eq a) => PutlensM m a [a]

example of automatically deriving constructor/destructor putlenses for binary trees

data Tree a

Constructors

Empty

Node a (Tree a) (Tree a)

Instances

Generic (Tree a)

type Rep (Tree a)

unnodePut :: forall m a. Monad m => PutlensM m (a, (Tree a, Tree a)) (Tree a)

nodePut :: forall m a. Monad m => PutlensM m (Tree a) (a, (Tree a, Tree a))

unemptyPut :: forall m a. Monad m => PutlensM m () (Tree a)

emptyPut :: forall m a. Monad m => PutlensM m (Tree a) ()

List concatenation

catPut :: (Monad m, Eq a) => PutlensM m ([a], [a]) [a]

List concatenation (positional)

exCatPut1 :: [Integer]

exCatPut2 :: Identity ([Integer], [Integer])

exCatPut3 :: Identity ([Integer], [Integer])

exCatPut4 :: Identity ([Integer], [Integer])

catPutN :: (Monad m, Eq a) => (Maybe ([a], [a]) -> [a] -> Int) -> PutlensM m ([a], [a]) [a]

List concatenation (split the view list at position n-1)

catPutN' :: (Monad m, Eq a) => PutlensStateM m Int ([a], [a]) [a]

catPut2 :: Eq a => PutlensM Identity ([a], [a]) [a]

List concatenation (split the view list in half)

exCatPut21 :: [Integer]

exCatPut22 :: Identity ([Integer], [Integer])

exCatPut23 :: Identity ([Integer], [Integer])

exCatPut24 :: Identity ([Integer], [Integer])

catPutP :: (Monad m, Eq a) => (Maybe (Either [a] [a]) -> a -> m Bool) -> PutlensM m ([a], [a]) [a]

List concatenation (puts elements to the left while satisfying a predicate)

catPutSame :: (Monad m, Eq a) => PutlensM m ([a], [a]) [a]

List concatenation (puts elements to the left while being equal)

catPutSameMb :: Eq a => PutlensM Identity ([a], [a]) [a]

exCatPutSame1 :: [Integer]

exCatPutSame2 :: Identity ([Integer], [Integer])

exCatPutSame3 :: Identity ([Integer], [Integer])

catPutPred :: (Monad m, Ord a) => a -> PutlensM m ([a], [a]) [a]

List concatenation (puts elements to the left while smaller than a particular value)

catPutPredMb :: Ord a => a -> PutlensM Identity ([a], [a]) [a]

exCatPutPred1 :: [Integer]

exCatPutPred2 :: Identity ([Integer], [Integer])

exCatPutPred3 :: Identity ([Integer], [Integer])

exCatPutPred4 :: Identity ([Integer], [Integer])

filterlPut :: (Monad m, Eq a, Eq b) => PutlensM m [Either a b] [a]

Left list filtering lens (but will drop some right elements if the view list is smaller). The argument passed to keepfstOrPut can be undefined because it will never be used

filterrPut :: (Monad m, Eq a, Eq b) => PutlensM m [Either a b] [b]

Right list filtering lens (but will drop some left elements if the view list is smaller). The argument passed to keepsndOrPut can be undefined because it will never be used

partitionPut :: (Monad m, Eq a, Eq b) => Bool -> PutlensM m [Either a b] ([a], [b])

List filtering lens that splits a list of eithers into a list two lists. The boolean argument allows controlling the priority of left/right values in the source list.

filterleftPut :: (Monad m, Eq a, Eq b) => PutlensM m [Either a b] [a]

Left list filtering lens (that recovers all right elements).

filterPut :: (Monad m, Eq a) => (a -> Bool) -> PutlensM m [a] [a]

filterrightPut :: (Monad m, Eq a, Eq b) => PutlensM m [Either a b] [b]

Right list filtering lens (that recovers all left elements).

Integers

succPut :: Monad m => PutlensM m Int Int

predPut :: Monad m => PutlensM m Int Int

Naturals

data Nat

Constructors

ZeroN

SuccN Nat

Instances

Eq Nat

Show Nat

Generic Nat

type Rep Nat

unsuccNPut :: forall m. Monad m => PutlensM m Nat Nat

succNPut :: forall m. Monad m => PutlensM m Nat Nat

unzeroNPut :: forall m. Monad m => PutlensM m () Nat

zeroNPut :: forall m. Monad m => PutlensM m Nat ()

natPut :: Monad m => PutlensM m Nat Int

int :: Nat -> Int

nat :: Int -> Nat

List length

lengthNatPut :: (Monad m, Eq a) => (Int -> a) -> PutlensM m [a] Nat

Length as a natural number

exLengthNatPut1 :: Nat

exLengthNatPut2 :: Identity [Char]

exLengthNatPut3 :: Identity [Char]

List lookup

embedAtPut :: (Monad m, Eq a) => Int -> PutlensM m [a] a

Embeds a value at a fixed position in a list

embedAtPut1 :: (Monad m, Eq a) => Int -> PutlensM m [a] a

Embeds a value at a fixed position in a list (supports extending the length original list)

embedAtPut2 :: (Monad m, Eq a) => Int -> PutlensM m [a] a

Embeds a value at a fixed position in a list (source induction)

embedAtPut2' :: (Monad m, Eq a) => PutlensM m (Int, [a]) a

embedAtPut3 :: (Monad m, Eq a) => Int -> PutlensM m [a] a

Embeds a value at a fixed position in a list (supports extending the length original list) (source induction)

embedAtPut3' :: (Monad m, Eq a) => PutlensStateM m a (Int, [a]) a

exEmbedAtPut1 :: Char

exEmbedAtPut2 :: Identity [Char]

exEmbedAtPut3 :: Identity [Char]

exEmbedAtPut4 :: Char

exEmbedAtPut5 :: Identity [Char]

embedAtPut4 :: (Monad m, Eq a) => Int -> PutlensM m [a] a

Embeds a value at a fixed position in a list (splitAt approach)

splitAtPut :: (Monad m, Eq a) => PutlensM m (Int, [a]) ([a], [a])

exEmbedAtPut41 :: Char

exEmbedAtPut42 :: Identity [Char]

exEmbedAtPut43 :: Identity [Char]

List summation

splitPut :: (Monad m, Integral a) => ((a, a) -> a -> m a) -> PutlensM m (a, a) a

Splits a view number into two summands (by adding an offset to the original first value)

summandsPut1 :: (Monad m, Integral a) => PutlensM m [a] a

Updates the sum of a list (preserves the original source and appends the difference to the end)

summandsPut2 :: (Monad m, Integral a) => PutlensM m [a] a

Updates the sum of a list (distributes the difference by dividing it by two at each recursive step) half of the difference is added to the first element of the source, a quarter to the second, and so on until the remainder is 0

summandsPut3 :: (Monad m, Integral a) => PutlensM m [a] a

Updates the sum of a list (distributes the difference by dividing it by the length of the original list) distributes the difference evenly among original list numbers

summandsPut3' :: (Monad m, Integral a) => PutlensStateM m a [a] a

summandsPut4 :: (Monad m, Integral a) => PutlensM m [a] a

Updates the sum of a list (distributes the difference by dividing it by the length of the original list, always preserving the size of the original list even when the view is zero)

summandsPut4' :: (Monad m, Integral a) => PutlensStateM m a [a] a

exSummandsPut1 :: Integer

exSummandsPut2 :: [Integer]

exSummandsPut3 :: [Integer]

exSummandsPut4 :: [Integer]

exSummandsPut5 :: [Integer]

exSummandsPut6 :: [Integer]

exSummandsPut7 :: [Integer]

Replicate

replicatePut :: (Monad m, Eq a) => PutlensM m (a, Int) [a]

Replicate

exReplicatePut1 :: Identity (Char, Int)

exReplicatePut2 :: Identity (Char, Int)

replicateListPut :: (Monad m, Eq a) => PutlensM m [(a, Int)] [a]

Replicates a list of elements into a sequence of replicated elements

recoverzerosPut :: (Monad m, Eq a) => PutlensM m [(a, Int)] [(a, Int)]

splitListPut :: (Monad m, Eq a) => PutlensM m [[a]] [a]

exReplicateListPut1 :: [Char]

exReplicateListPut2 :: Identity [(Char, Int)]

Halve

halvePut :: (Monad m, Eq a) => a -> PutlensM m [a] [a]

Takes the first half of a list (with a default empty element)

halvePutMb :: Eq a => a -> PutlensM Identity [a] [a]

exHalvePut1 :: Identity [Char]

exHalvePut2 :: Identity [Char]

halvePut2 :: (Monad m, Eq a) => a -> PutlensM m [a] [a]

Takes the first half of a list (using an increasing counter with each consumed element in the forward direction)

halvePut2' :: (Monad m, Eq a) => a -> PutlensM m ([a], Int) ([a], Int)

exHalvePut21 :: Identity [Char]

exHalvePut22 :: Identity [Char]

exHalvePut23 :: Identity [Char]

halvePut3 :: (Monad m, Eq a) => a -> PutlensM m [a] [a]

Takes the first half of a list (using a decreasing counter with the size of the input list, decreased 2 by 2, in the forward direction)

halvePut3' :: (Monad m, Eq a) => a -> PutlensStateM m Int ([a], Int) [a]

exHalvePut31 :: Identity [Char]

exHalvePut32 :: Identity [Char]

exHalvePut33 :: Identity [Char]

isumPut :: Monad m => PutlensM m [Int] [Int]

Incremental summation

subtractPut :: Monad m => Int -> PutlensM m Int Int

exIsumPut1 :: [Int]

exIsumPut2 :: Identity [Int]

Sorting

iunsortPut1 :: (Monad m, Ord a) => PutlensM m [a] [a]

Insertion sort (put according to the original relative source order)

delPut1 :: (Monad m, Ord a) => PutlensM m (a, [a]) [a]

iunsortPut2 :: (Monad m, Ord a) => PutlensM m [a] [a]

Insertion sort (identity backward transformation)

delPut2 :: (Monad m, Ord a) => PutlensM m (a, [a]) [a]

exIunsortPut1 :: [Integer]

exIunsortPut2 :: [Integer]

exIunsortPut3 :: [Integer]

qsortPut :: (Monad m, Ord a) => PutlensM m [a] [a]

Quicksort (put according to the original relative source order)

qpartitionPut :: (Monad m, Ord a) => PutlensM m (a, [a]) (a, ([a], [a]))

Partition a list into smaller and bigger elements than a given element

catPutNonEmptyRight :: (Monad m, Eq a) => PutlensM m ([a], [a]) [a]

exQsortPut1 :: [Integer]

exQsortPut2 :: [Integer]

exQsortPut3 :: [Integer]

positionsPut :: (Monad m, Eq a) => PutlensM m [a] [(Int, a)]

Adds positions to a list (using an higher-order function)

positionsPut' :: (Monad m, Eq a) => Int -> PutlensM m [a] [(Int, a)]

positionsPut2 :: (Monad m, Eq a) => PutlensM m [a] [(Int, a)]

Adds positions to a list (using environment)

positionsPut2' :: (Monad m, Eq a) => PutlensReaderM m [(Int, a)] (Int, [a]) [(Int, a)]

exIntitions1 :: [(Int, Char)]

exIntitions2 :: [Char]

exIntitions3 :: [Char]

Exception handling

appendWithSepPut :: Monad m => String -> PutlensM m (String, String) String

Appends two strings with a separating space

readPut :: (MonadPlus m, Read a, Show a) => PutlensM m a String

Parsingpretty-printing lens version using readshow

unwordsIntBool :: PutlensM Maybe [Either Int Bool] String

Parses a string into a sequence of Int or Bool values separated by a single space

unwordsPut :: PutlensM Maybe [String] String

Putlens inverse of unwords

unfoldr1Put :: (MonadPlus m, Eq a) => PutlensM m (a, a) a -> PutlensM m [a] a

Putlens inverse of foldr1, a specialization of foldr for non-empty lists