| Copyright | (c) The University of Glasgow 2001 |
|---|---|
| License | BSD-style (see the file libraries/base/LICENSE) |
| Maintainer | libraries@haskell.org |
| Stability | provisional |
| Portability | portable |
| Safe Haskell | Trustworthy |
| Language | Haskell2010 |
Data.Functor
Description
Functors: uniform action over a parameterized type, generalizing the map function on lists.
Documentation
The Functor class is used for types that can be mapped over. Instances of Functor should satisfy the following laws:
fmap id == id fmap (f . g) == fmap f . fmap g
The instances of Functor for lists, Maybe and IO satisfy these laws.
Minimal complete definition
Instances
| Functor [] Source | |
| Functor IO Source | |
| Functor Maybe Source | |
| Functor ReadP Source | |
| Functor ReadPrec Source | |
| Functor Last Source | |
| Functor First Source | |
| Functor STM Source | |
| Functor Handler Source | |
| Functor ZipList Source | |
| Functor Identity Source | |
| Functor ArgDescr Source | |
| Functor OptDescr Source | |
| Functor ArgOrder Source | |
| Functor ((->) r) Source | |
| Functor (Either a) Source | |
| Functor ((,) a) Source | |
| Functor (ST s) Source | |
| Functor (Proxy *) Source | |
| Arrow a => Functor (ArrowMonad a) Source | |
| Monad m => Functor (WrappedMonad m) Source | |
| Functor (Const m) Source | |
| Functor (ST s) Source | |
| Functor f => Functor (Alt * f) Source | |
| Arrow a => Functor (WrappedArrow a b) Source |
($>) :: Functor f => f a -> b -> f b infixl 4 Source
Flipped version of <$.
Examples
Replace the contents of a with a constant Maybe IntString:
>>>Nothing $> "foo"Nothing>>>Just 90210 $> "foo"Just "foo"
Replace the contents of an with a constant Either Int IntString, resulting in an :Either Int String
>>>Left 8675309 $> "foo"Left 8675309>>>Right 8675309 $> "foo"Right "foo"
Replace each element of a list with a constant String:
>>>[1,2,3] $> "foo"["foo","foo","foo"]
Replace the second element of a pair with a constant String:
>>>(1,2) $> "foo"(1,"foo")
Since: 4.7.0.0
(<$>) :: Functor f => (a -> b) -> f a -> f b infixl 4 Source
An infix synonym for fmap.
Examples
Convert from a to a Maybe Int using Maybe Stringshow:
>>>show <$> NothingNothing>>>show <$> Just 3Just "3"
Convert from an to an Either Int IntEither IntString using show:
>>>show <$> Left 17Left 17>>>show <$> Right 17Right "17"
Double each element of a list:
>>>(*2) <$> [1,2,3][2,4,6]
Apply even to the second element of a pair:
>>>even <$> (2,2)(2,True)
void :: Functor f => f a -> f () Source
discards or ignores the result of evaluation, such as the return value of an void valueIO action.
Examples
Replace the contents of a with unit:Maybe Int
>>>void NothingNothing>>>void (Just 3)Just ()
Replace the contents of an with unit, resulting in an Either Int Int:Either Int '()'
>>>void (Left 8675309)Left 8675309>>>void (Right 8675309)Right ()
Replace every element of a list with unit:
>>>void [1,2,3][(),(),()]
Replace the second element of a pair with unit:
>>>void (1,2)(1,())
Discard the result of an IO action:
>>>mapM print [1,2]1 2 [(),()]>>>void $ mapM print [1,2]1 2