| Copyright | 2009-2015 Edward Kmett |
|---|---|
| License | BSD3 |
| Maintainer | Edward Kmett <ekmett@gmail.com> |
| Stability | experimental |
| Portability | portable |
| Safe Haskell | Safe |
| Language | Haskell98 |
Data.Tagged
Description
Synopsis
- newtype Tagged s b = Tagged {
- unTagged :: b
- retag :: Tagged s b -> Tagged t b
- untag :: Tagged s b -> b
- tagSelf :: a -> Tagged a a
- untagSelf :: Tagged a a -> a
- asTaggedTypeOf :: s -> tagged s b -> s
- witness :: Tagged a b -> a -> b
- proxy :: Tagged s a -> proxy s -> a
- unproxy :: (Proxy s -> a) -> Tagged s a
- tagWith :: proxy s -> a -> Tagged s a
- reproxy :: proxy a -> Proxy b
Tagged values
A value is a value Tagged s bb with an attached phantom type s.
This can be used in place of the more traditional but less safe idiom of
passing in an undefined value with the type, because unlike an (s -> b),
a can't try to use the argument Tagged s bs as a real value.
Moreover, you don't have to rely on the compiler to inline away the extra argument, because the newtype is "free"
Tagged has kind k -> * -> * if the compiler supports PolyKinds, therefore
there is an extra k showing in the instance haddocks that may cause confusion.
Instances
| Eq2 (Tagged :: Type -> Type -> Type) Source # | |
Defined in Data.Tagged | |
| Ord2 (Tagged :: Type -> Type -> Type) Source # | |
Defined in Data.Tagged Methods liftCompare2 :: (a -> b -> Ordering) -> (c -> d -> Ordering) -> Tagged a c -> Tagged b d -> Ordering | |
| Read2 (Tagged :: Type -> Type -> Type) Source # | |
Defined in Data.Tagged Methods liftReadsPrec2 :: (Int -> ReadS a) -> ReadS [a] -> (Int -> ReadS b) -> ReadS [b] -> Int -> ReadS (Tagged a b) liftReadList2 :: (Int -> ReadS a) -> ReadS [a] -> (Int -> ReadS b) -> ReadS [b] -> ReadS [Tagged a b] liftReadPrec2 :: ReadPrec a -> ReadPrec [a] -> ReadPrec b -> ReadPrec [b] -> ReadPrec (Tagged a b) liftReadListPrec2 :: ReadPrec a -> ReadPrec [a] -> ReadPrec b -> ReadPrec [b] -> ReadPrec [Tagged a b] | |
| Show2 (Tagged :: Type -> Type -> Type) Source # | |
Defined in Data.Tagged Methods liftShowsPrec2 :: (Int -> a -> ShowS) -> ([a] -> ShowS) -> (Int -> b -> ShowS) -> ([b] -> ShowS) -> Int -> Tagged a b -> ShowS liftShowList2 :: (Int -> a -> ShowS) -> ([a] -> ShowS) -> (Int -> b -> ShowS) -> ([b] -> ShowS) -> [Tagged a b] -> ShowS | |
| Bifunctor (Tagged :: Type -> Type -> Type) Source # | |
| Bifoldable (Tagged :: Type -> Type -> Type) Source # | |
| Bitraversable (Tagged :: Type -> Type -> Type) Source # | |
Defined in Data.Tagged Methods bitraverse :: Applicative f => (a -> f c) -> (b -> f d) -> Tagged a b -> f (Tagged c d) | |
| Generic1 (Tagged s :: Type -> Type) Source # | |
| Monad (Tagged s) Source # | |
| Functor (Tagged s) Source # | |
| Applicative (Tagged s) Source # | |
| Foldable (Tagged s) Source # | |
Defined in Data.Tagged Methods fold :: Monoid m => Tagged s m -> m foldMap :: Monoid m => (a -> m) -> Tagged s a -> m foldMap' :: Monoid m => (a -> m) -> Tagged s a -> m foldr :: (a -> b -> b) -> b -> Tagged s a -> b foldr' :: (a -> b -> b) -> b -> Tagged s a -> b foldl :: (b -> a -> b) -> b -> Tagged s a -> b foldl' :: (b -> a -> b) -> b -> Tagged s a -> b foldr1 :: (a -> a -> a) -> Tagged s a -> a foldl1 :: (a -> a -> a) -> Tagged s a -> a elem :: Eq a => a -> Tagged s a -> Bool maximum :: Ord a => Tagged s a -> a minimum :: Ord a => Tagged s a -> a | |
| Traversable (Tagged s) Source # | |
| Eq1 (Tagged s) Source # | |
Defined in Data.Tagged | |
| Ord1 (Tagged s) Source # | |
Defined in Data.Tagged Methods liftCompare :: (a -> b -> Ordering) -> Tagged s a -> Tagged s b -> Ordering | |
| Read1 (Tagged s) Source # | |
Defined in Data.Tagged Methods liftReadsPrec :: (Int -> ReadS a) -> ReadS [a] -> Int -> ReadS (Tagged s a) liftReadList :: (Int -> ReadS a) -> ReadS [a] -> ReadS [Tagged s a] liftReadPrec :: ReadPrec a -> ReadPrec [a] -> ReadPrec (Tagged s a) liftReadListPrec :: ReadPrec a -> ReadPrec [a] -> ReadPrec [Tagged s a] | |
| Show1 (Tagged s) Source # | |
Defined in Data.Tagged Methods liftShowsPrec :: (Int -> a -> ShowS) -> ([a] -> ShowS) -> Int -> Tagged s a -> ShowS liftShowList :: (Int -> a -> ShowS) -> ([a] -> ShowS) -> [Tagged s a] -> ShowS | |
| Bounded b => Bounded (Tagged s b) Source # | |
Defined in Data.Tagged | |
| Enum a => Enum (Tagged s a) Source # | |
Defined in Data.Tagged | |
| Eq b => Eq (Tagged s b) Source # | |
| Floating a => Floating (Tagged s a) Source # | |
Defined in Data.Tagged Methods exp :: Tagged s a -> Tagged s a log :: Tagged s a -> Tagged s a sqrt :: Tagged s a -> Tagged s a (**) :: Tagged s a -> Tagged s a -> Tagged s a logBase :: Tagged s a -> Tagged s a -> Tagged s a sin :: Tagged s a -> Tagged s a cos :: Tagged s a -> Tagged s a tan :: Tagged s a -> Tagged s a asin :: Tagged s a -> Tagged s a acos :: Tagged s a -> Tagged s a atan :: Tagged s a -> Tagged s a sinh :: Tagged s a -> Tagged s a cosh :: Tagged s a -> Tagged s a tanh :: Tagged s a -> Tagged s a asinh :: Tagged s a -> Tagged s a acosh :: Tagged s a -> Tagged s a atanh :: Tagged s a -> Tagged s a log1p :: Tagged s a -> Tagged s a expm1 :: Tagged s a -> Tagged s a | |
| Fractional a => Fractional (Tagged s a) Source # | |
Defined in Data.Tagged | |
| Integral a => Integral (Tagged s a) Source # | |
Defined in Data.Tagged Methods quot :: Tagged s a -> Tagged s a -> Tagged s a rem :: Tagged s a -> Tagged s a -> Tagged s a div :: Tagged s a -> Tagged s a -> Tagged s a mod :: Tagged s a -> Tagged s a -> Tagged s a quotRem :: Tagged s a -> Tagged s a -> (Tagged s a, Tagged s a) divMod :: Tagged s a -> Tagged s a -> (Tagged s a, Tagged s a) | |
| (Data s, Data b) => Data (Tagged s b) Source # | |
Defined in Data.Tagged Methods gfoldl :: (forall d b0. Data d => c (d -> b0) -> d -> c b0) -> (forall g. g -> c g) -> Tagged s b -> c (Tagged s b) gunfold :: (forall b0 r. Data b0 => c (b0 -> r) -> c r) -> (forall r. r -> c r) -> Constr -> c (Tagged s b) toConstr :: Tagged s b -> Constr dataTypeOf :: Tagged s b -> DataType dataCast1 :: Typeable t => (forall d. Data d => c (t d)) -> Maybe (c (Tagged s b)) dataCast2 :: Typeable t => (forall d e. (Data d, Data e) => c (t d e)) -> Maybe (c (Tagged s b)) gmapT :: (forall b0. Data b0 => b0 -> b0) -> Tagged s b -> Tagged s b gmapQl :: (r -> r' -> r) -> r -> (forall d. Data d => d -> r') -> Tagged s b -> r gmapQr :: forall r r'. (r' -> r -> r) -> r -> (forall d. Data d => d -> r') -> Tagged s b -> r gmapQ :: (forall d. Data d => d -> u) -> Tagged s b -> [u] gmapQi :: Int -> (forall d. Data d => d -> u) -> Tagged s b -> u gmapM :: Monad m => (forall d. Data d => d -> m d) -> Tagged s b -> m (Tagged s b) gmapMp :: MonadPlus m => (forall d. Data d => d -> m d) -> Tagged s b -> m (Tagged s b) gmapMo :: MonadPlus m => (forall d. Data d => d -> m d) -> Tagged s b -> m (Tagged s b) | |
| Num a => Num (Tagged s a) Source # | |
Defined in Data.Tagged | |
| Ord b => Ord (Tagged s b) Source # | |
| Read b => Read (Tagged s b) Source # | |
Defined in Data.Tagged | |
| Real a => Real (Tagged s a) Source # | |
Defined in Data.Tagged Methods toRational :: Tagged s a -> Rational | |
| RealFloat a => RealFloat (Tagged s a) Source # | |
Defined in Data.Tagged Methods floatRadix :: Tagged s a -> Integer floatDigits :: Tagged s a -> Int floatRange :: Tagged s a -> (Int, Int) decodeFloat :: Tagged s a -> (Integer, Int) encodeFloat :: Integer -> Int -> Tagged s a significand :: Tagged s a -> Tagged s a scaleFloat :: Int -> Tagged s a -> Tagged s a isInfinite :: Tagged s a -> Bool isDenormalized :: Tagged s a -> Bool isNegativeZero :: Tagged s a -> Bool | |
| RealFrac a => RealFrac (Tagged s a) Source # | |
| Show b => Show (Tagged s b) Source # | |
| Ix b => Ix (Tagged s b) Source # | |
Defined in Data.Tagged Methods range :: (Tagged s b, Tagged s b) -> [Tagged s b] index :: (Tagged s b, Tagged s b) -> Tagged s b -> Int unsafeIndex :: (Tagged s b, Tagged s b) -> Tagged s b -> Int inRange :: (Tagged s b, Tagged s b) -> Tagged s b -> Bool rangeSize :: (Tagged s b, Tagged s b) -> Int unsafeRangeSize :: (Tagged s b, Tagged s b) -> Int | |
| IsString a => IsString (Tagged s a) Source # | |
Defined in Data.Tagged Methods fromString :: String -> Tagged s a | |
| Generic (Tagged s b) Source # | |
| Semigroup a => Semigroup (Tagged s a) Source # | |
| (Semigroup a, Monoid a) => Monoid (Tagged s a) Source # | |
| Bits a => Bits (Tagged s a) Source # | |
Defined in Data.Tagged Methods (.&.) :: Tagged s a -> Tagged s a -> Tagged s a (.|.) :: Tagged s a -> Tagged s a -> Tagged s a xor :: Tagged s a -> Tagged s a -> Tagged s a complement :: Tagged s a -> Tagged s a shift :: Tagged s a -> Int -> Tagged s a rotate :: Tagged s a -> Int -> Tagged s a setBit :: Tagged s a -> Int -> Tagged s a clearBit :: Tagged s a -> Int -> Tagged s a complementBit :: Tagged s a -> Int -> Tagged s a testBit :: Tagged s a -> Int -> Bool bitSizeMaybe :: Tagged s a -> Maybe Int isSigned :: Tagged s a -> Bool shiftL :: Tagged s a -> Int -> Tagged s a unsafeShiftL :: Tagged s a -> Int -> Tagged s a shiftR :: Tagged s a -> Int -> Tagged s a unsafeShiftR :: Tagged s a -> Int -> Tagged s a rotateL :: Tagged s a -> Int -> Tagged s a | |
| FiniteBits a => FiniteBits (Tagged s a) Source # | |
Defined in Data.Tagged Methods finiteBitSize :: Tagged s a -> Int countLeadingZeros :: Tagged s a -> Int countTrailingZeros :: Tagged s a -> Int | |
| NFData b => NFData (Tagged s b) Source # | |
Defined in Data.Tagged | |
| Storable a => Storable (Tagged s a) Source # | |
Defined in Data.Tagged Methods alignment :: Tagged s a -> Int peekElemOff :: Ptr (Tagged s a) -> Int -> IO (Tagged s a) pokeElemOff :: Ptr (Tagged s a) -> Int -> Tagged s a -> IO () peekByteOff :: Ptr b -> Int -> IO (Tagged s a) pokeByteOff :: Ptr b -> Int -> Tagged s a -> IO () | |
| type Rep1 (Tagged s :: Type -> Type) Source # | |
Defined in Data.Tagged type Rep1 (Tagged s :: Type -> Type) = D1 ('MetaData "Tagged" "Data.Tagged" "tagged-0.8.6-FYc8l1vwILF5OSKkSTSNII" 'True) (C1 ('MetaCons "Tagged" 'PrefixI 'True) (S1 ('MetaSel ('Just "unTagged") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedLazy) Par1)) | |
| type Rep (Tagged s b) Source # | |
Defined in Data.Tagged type Rep (Tagged s b) = D1 ('MetaData "Tagged" "Data.Tagged" "tagged-0.8.6-FYc8l1vwILF5OSKkSTSNII" 'True) (C1 ('MetaCons "Tagged" 'PrefixI 'True) (S1 ('MetaSel ('Just "unTagged") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedLazy) (Rec0 b))) | |
asTaggedTypeOf :: s -> tagged s b -> s Source #
asTaggedTypeOf is a type-restricted version of const. It is usually used as an infix operator, and its typing forces its first argument (which is usually overloaded) to have the same type as the tag of the second.
Conversion
proxy :: Tagged s a -> proxy s -> a Source #
Convert from a Tagged representation to a representation
based on a Proxy.
unproxy :: (Proxy s -> a) -> Tagged s a Source #
Convert from a representation based on a Proxy to a Tagged
representation.