{-# LANGUAGE KindSignatures #-} {-# LANGUAGE BangPatterns #-} {-# LANGUAGE RankNTypes #-} {-# LANGUAGE TypeFamilies #-} {-# OPTIONS_GHC -O2 -Wall #-} module Data.Map.Lifted.Lifted ( Map , singleton , lookup , size , map , mapMaybe -- * Folds , foldlWithKey' , foldrWithKey' , foldMapWithKey' -- * Monadic Folds , foldlWithKeyM' , foldrWithKeyM' , foldlMapWithKeyM' , foldrMapWithKeyM' -- * List Conversion , fromList , fromListAppend , fromListN , fromListAppendN ) where import Prelude hiding (lookup,map) import Data.Semigroup (Semigroup) import Data.Primitive.Array (Array) import qualified GHC.Exts as E import qualified Data.Semigroup as SG import qualified Data.Map.Internal as I -- | A map from keys @k@ to values @v@. The key type and the value -- type must both have 'Prim' instances. newtype Map k v = Map (I.Map Array Array k v) instance (Ord k, Semigroup v) => Semigroup (Map k v) where Map x <> Map y = Map (I.append x y) instance (Ord k, Semigroup v) => Monoid (Map k v) where mempty = Map I.empty mappend = (SG.<>) mconcat = Map . I.concat . E.coerce instance (Eq k, Eq v) => Eq (Map k v) where Map x == Map y = I.equals x y instance (Ord k, Ord v) => Ord (Map k v) where compare (Map x) (Map y) = I.compare x y instance Ord k => E.IsList (Map k v) where type Item (Map k v) = (k,v) fromListN n = Map . I.fromListN n fromList = Map . I.fromList toList (Map s) = I.toList s instance (Show k, Show v) => Show (Map k v) where showsPrec p (Map s) = I.showsPrec p s -- | /O(log n)/ Lookup the value at a key in the map. lookup :: Ord k => k -> Map k v -> Maybe v lookup a (Map s) = I.lookup a s -- | /O(1)/ Create a map with a single element. singleton :: k -> v -> Map k v singleton k v = Map (I.singleton k v) -- | /O(n*log n)/ Create a map from a list of key-value pairs. -- If the list contains more than one value for the same key, -- the last value is retained. If the keys in the argument are -- in nondescending order, this algorithm runs in /O(n)/ time instead. fromList :: Ord k => [(k,v)] -> Map k v fromList = Map . I.fromList -- | /O(n*log n)/ This function has the same behavior as 'fromList' -- regardless of whether or not the expected size is accurate. Additionally, -- negative sizes are handled correctly. The expected size is used as the -- size of the initially allocated buffer when building the 'Map'. If the -- keys in the argument are in nondescending order, this algorithm runs -- in /O(n)/ time. fromListN :: Ord k => Int -- ^ expected size of resulting 'Map' -> [(k,v)] -- ^ key-value pairs -> Map k v fromListN n = Map . I.fromListN n -- | /O(n*log n)/ This function has the same behavior as 'fromList', -- but it combines values with the 'Semigroup' instances instead of -- choosing the last occurrence. fromListAppend :: (Ord k, Semigroup v) => [(k,v)] -> Map k v fromListAppend = Map . I.fromListAppend -- | /O(n*log n)/ This function has the same behavior as 'fromListN', -- but it combines values with the 'Semigroup' instances instead of -- choosing the last occurrence. fromListAppendN :: (Ord k, Semigroup v) => Int -- ^ expected size of resulting 'Map' -> [(k,v)] -- ^ key-value pairs -> Map k v fromListAppendN n = Map . I.fromListAppendN n -- | /O(1)/ The number of elements in the map. size :: Map k v -> Int size (Map m) = I.size m -- | /O(n)/ Map over the values in the map. map :: (v -> w) -> Map k v -> Map k w map f (Map m) = Map (I.map f m) -- | /O(n)/ Drop elements for which the predicate returns 'Nothing'. mapMaybe :: (v -> Maybe w) -> Map k v -> Map k w mapMaybe f (Map m) = Map (I.mapMaybe f m) -- | /O(n)/ Left monadic fold over the keys and values of the map. This fold -- is strict in the accumulator. foldlWithKeyM' :: Monad m => (b -> k -> v -> m b) -- ^ reduction -> b -- ^ initial accumulator -> Map k v -- ^ map -> m b foldlWithKeyM' f b0 (Map m) = I.foldlWithKeyM' f b0 m -- | /O(n)/ Right monadic fold over the keys and values of the map. This fold -- is strict in the accumulator. foldrWithKeyM' :: Monad m => (k -> v -> b -> m b) -- ^ reduction -> b -- ^ initial accumulator -> Map k v -- ^ map -> m b foldrWithKeyM' f b0 (Map m) = I.foldrWithKeyM' f b0 m -- | /O(n)/ Monadic left fold over the keys and values of the map with a strict -- monoidal accumulator. The monoidal accumulator is appended to the left -- after each reduction. foldlMapWithKeyM' :: (Monad m, Monoid b) => (k -> v -> m b) -- ^ reduction -> Map k v -- ^ map -> m b foldlMapWithKeyM' f (Map m) = I.foldlMapWithKeyM' f m -- | /O(n)/ Monadic right fold over the keys and values of the map with a strict -- monoidal accumulator. The monoidal accumulator is appended to the right -- after each reduction. foldrMapWithKeyM' :: (Monad m, Monoid b) => (k -> v -> m b) -- ^ reduction -> Map k v -- ^ map -> m b foldrMapWithKeyM' f (Map m) = I.foldrMapWithKeyM' f m -- | /O(n)/ Fold over the keys and values of the map with a strict monoidal -- accumulator. This function does not have left and right variants since -- the associativity required by a monoid instance means that both variants -- would always produce the same result. foldMapWithKey' :: Monoid b => (k -> v -> b) -- ^ reduction -> Map k v -- ^ map -> b foldMapWithKey' f (Map m) = I.foldMapWithKey' f m -- | /O(n)/ Left fold over the keys and values with a strict accumulator. foldlWithKey' :: (b -> k -> v -> b) -- ^ reduction -> b -- ^ initial accumulator -> Map k v -- ^ map -> b foldlWithKey' f b0 (Map m) = I.foldlWithKey' f b0 m -- | /O(n)/ Right fold over the keys and values with a strict accumulator. foldrWithKey' :: (k -> v -> b -> b) -- ^ reduction -> b -- ^ initial accumulator -> Map k v -- ^ map -> b foldrWithKey' f b0 (Map m) = I.foldrWithKey' f b0 m