Data.Functor
| Авторские права | (c) Университет Глазго 2001 |
|---|---|
| Лицензия | BSD-стиль (см. файл libraries/base/LICENSE) |
| Поддержка | libraries@haskell.org |
| Стабильность | предварительная |
| Переносимость | переносимая |
| Safe Haskell | Безопасный |
| Язык | Haskell2010 |
Описание
Тип f является Functor, если он предоставляет функцию fmap, которая, учитывая любые типы a и b, позволяет применить любую функцию типа (a -> b), чтобы преобразовать f a в f b, сохраняя структуру f.
class Functor (f :: Type -> Type) where Исходный код
Тип f является Functor, если он предоставляет функцию fmap, которая, учитывая любые типы a и b, позволяет применить любую функцию из (a -> b), чтобы преобразовать f a в f b, сохраняя структуру f. Кроме того, f должен соответствовать следующим условиям:
Обратите внимание, что второе правило следует из свободной теоремы типа fmap и первого правила, поэтому вам нужно проверить только выполнение первого условия. Для объяснения обратитесь к этим статьям от Школы Haskell или Дэвида Лупошайнского.
Минимальное полное определение
Методы
fmap :: (a -> b) -> f a -> f b Исходный код
fmap используется для применения функции типа (a -> b) к значению типа f a, где f — фукнтор, чтобы получить значение типа f b. Обратите внимание, что для любого конструктора типов с более чем одним параметром (например, Either), только последний параметр типа может быть изменён с помощью fmap (например, b в `Either a b`).
Некоторые конструкторы типов с двумя и более параметрами имеют экземпляр Bifunctor, который позволяет отобразить и последний, и предпоследний параметры.
Примеры
Преобразование из Maybe Int в Maybe String с помощью show:
>>> fmap show Nothing Nothing >>> fmap show (Just 3) Just "3"
Преобразование из Either Int Int в Either Int String с помощью show:
>>> fmap show (Left 17) Left 17 >>> fmap show (Right 17) Right "17"
Удвоение каждого элемента списка:
>>> fmap (*2) [1,2,3] [2,4,6]
Применение even ко второму элементу пары:
>>> fmap even (2,2) (2,True)
Может показаться удивительным, что функция применяется только к последнему элементу кортежа по сравнению с примером со списком, где она применяется ко всем элементам списка. Чтобы понять это, помните, что кортежи являются конструкторами типов с несколькими параметрами типа: кортеж из 3 элементов (a,b,c) также может быть записан как (,,) a b c, и его экземпляр Functor определён для Functor ((,,) a b) (то есть только третий параметр может быть преобразован с помощью fmap).
Это объясняет, почему fmap может использоваться с кортежами, содержащими значения разных типов, как в следующем примере:
>>> fmap even ("hello", 1.0, 4)
("hello",1.0,True)
(<$) :: a -> f b -> f a infixl 4 Исходный код
Замена всех позиций в вводе одним и тем же значением. По умолчанию определение равно fmap . const, но оно может быть переопределено более эффективной версией.
Примеры
Экземпляры
| Functor Произведение Источник | С момента: base-4.8.0.0 |
Определено в GHC.Internal.Data.Semigroup.Internal Методыfmap :: (a -> b) -> Произведение a -> Произведение b Источник (<$) :: a -> Произведение b -> Произведение a Источник | |
| Functor Сумма Источник | С момента: base-4.8.0.0 |
| Functor ZipList Источник | С момента: base-2.1 |
| Functor NoIO Источник | С момента: base-4.8.0.0 |
| Functor Par1 Источник | С момента: base-4.9.0.0 |
| Functor Q Источник | |
| Functor TyVarBndr Источник | |
| Functor P Источник | С момента: base-4.8.0.0 |
Определено в GHC.Internal.Text.ParserCombinators.ReadP | |
| Functor ReadP Источник | С момента: base-2.1 |
| Functor ReadPrec Источник | С момента: base-2.1 |
| Functor IO Источник | С момента: base-2.1 |
| Functor Maybe Источник | С момента: base-2.1 |
| Functor Solo Источник | С момента: base-4.15 |
| Functor [] Источник | С момента: base-2.1 |
Определено в GHC.Internal.Base | |
| Monad m => Functor (WrappedMonad m) Источник | С момента: base-2.1 |
Определено в Control.Applicative Методыfmap :: (a -> b) -> WrappedMonad m a -> WrappedMonad m b Источник (<$) :: a -> WrappedMonad m b -> WrappedMonad m a Источник | |
| Functor (Arg a) Источник | С момента: base-4.9.0.0 |
| Functor (Proxy :: Type -> Type) Source | Since: base-4.7.0.0 |
| Functor (U1 :: Type -> Type) Source | Since: base-4.9.0.0 |
| Functor (V1 :: Type -> Type) Source | Since: base-4.9.0.0 |
| Functor (ST s) Source | Since: base-2.1 |
| Functor ((,) a) Source | Since: base-2.1 |
Определено в GHC.Internal.Base | |
| Arrow a => Functor (WrappedArrow a b) Source | Since: base-2.1 |
Определено в Control.Applicative Методыfmap :: (a0 -> b0) -> WrappedArrow a b a0 -> WrappedArrow a b b0 Source (<$) :: a0 -> WrappedArrow a b b0 -> WrappedArrow a b a0 Source | |
| Functor m => Functor (Kleisli m a) Source | Since: base-4.14.0.0 |
| Functor (Const m :: Type -> Type) Source | Since: base-2.1 |
| Monad m => Functor (StateT s m) Источник | С момента: base-4.18.0.0 |
| Functor f => Functor (Ap f) Источник | С момента: base-4.12.0.0 |
| Functor f => Functor (Alt f) Источник | С момента: base-4.8.0.0 |
| Functor f => Functor (Generically1 f) Источник | С момента: base-4.17.0.0 |
Определено в GHC.Internal.Generics Методыfmap :: (a -> b) -> Generically1 f a -> Generically1 f b Источник (<$) :: a -> Generically1 f b -> Generically1 f a Источник | |
| Functor f => Functor (Rec1 f) Источник | С момента: base-4.9.0.0 |
| Functor (URec (Ptr ()) :: Type -> Type) Источник | С момента: base-4.9.0.0 |
| Functor (URec Char :: Type -> Type) Source | Since: base-4.9.0.0 |
| Functor (URec Double :: Type -> Type) Source | Since: base-4.9.0.0 |
| Functor (URec Float :: Type -> Type) Source | Since: base-4.9.0.0 |
| Functor (URec Int :: Type -> Type) Source | Since: base-4.9.0.0 |
| Functor (URec Word :: Type -> Type) Source | Since: base-4.9.0.0 |
| Functor ((,,) a b) Source | Since: base-4.14.0.0 |
Определено в GHC.Internal.Base | |
| (Functor f, Functor g) => Functor (Product f g) Source | Since: base-4.9.0.0 |
| (Functor f, Functor g) => Functor (Sum f g) Source | Since: base-4.9.0.0 |
| (Functor f, Functor g) => Functor (f :*: g) Source | Since: base-4.9.0.0 |
| (Functor f, Functor g) => Functor (f :+: g) Source | Since: base-4.9.0.0 |
| Functor (K1 i c :: Type -> Type) Source | Since: base-4.9.0.0 |
| Functor ((,,,) a b c) Source | Since: base-4.14.0.0 |
Определено в GHC.Internal.Base | |
| Functor ((->) r) Source | Since: base-2.1 |
Определено в GHC.Internal.Base | |
| (Functor f, Functor g) => Functor (Compose f g) Source | Since: base-4.9.0.0 |
| (Functor f, Functor g) => Functor (f :.: g) Source | Since: base-4.9.0.0 |
| Functor f => Functor (M1 i c f) Source | Since: base-4.9.0.0 |
| Functor ((,,,,) a b c d) Source | Since: base-4.18.0.0 |
Defined in GHC.Internal.Base | |
| Functor ((,,,,,) a b c d e) Source | Since: base-4.18.0.0 |
Defined in GHC.Internal.Base | |
| Functor ((,,,,,,) a b c d e f) Source | Since: base-4.18.0.0 |
Defined in GHC.Internal.Base | |
($>) :: Functor f => f a -> b -> f b infixl 4 Source
Перевернутая версия <$.
Примеры
Замените содержимое Maybe Int на константу String:
>>> Nothing $> "foo" Nothing
>>> Just 90210 $> "foo" Just "foo"
Замените содержимое Either Int Int на константу String, в результате чего получится Either
Int String:
>>> Left 8675309 $> "foo" Left 8675309
>>> Right 8675309 $> "foo" Right "foo"
Замените каждый элемент списка на константу String:
>>> [1,2,3] $> "foo" ["foo","foo","foo"]
Замените второй элемент пары на константу String:
>>> (1,2) $> "foo" (1,"foo")
Since: base-4.7.0.0
(<$>) :: Functor f => (a -> b) -> f a -> f b infixl 4 Source
Синоним infix для fmap.
Название этого оператора является аллюзией на $. Обратите внимание на сходство между их типами:
($) :: (a -> b) -> a -> b (<$>) :: Functor f => (a -> b) -> f a -> f b
В то время как $ является применением функции, <$> является применением функции, поднятым над Functor.
Примеры
Преобразуйте из Maybe Int в Maybe
String используя show:
>>> show <$> Nothing Nothing
>>> show <$> Just 3 Just "3"
Преобразуйте из Either Int Int в Either Int String используя show:
>>> show <$> Left 17 Left 17
>>> show <$> Right 17 Right "17"
Удвойте каждый элемент списка:
>>> (*2) <$> [1,2,3] [2,4,6]
Примените even ко второму элементу пары:
>>> even <$> (2,2) (2,True)
(<&>) :: Functor f => f a -> (a -> b) -> f b infixl 1 Source
Перевернутая версия <$>.
(<&>) = flip fmap
Примеры
Примените (+1) к списку, Just и Right:
>>> Just 2 <&> (+1) Just 3
>>> [1,2,3] <&> (+1) [2,3,4]
>>> Right 3 <&> (+1) Right 4
Since: base-4.11.0.0
unzip :: Functor f => f (a, b) -> (f a, f b) Source
Обобщение Data.List.unzip.
Примеры
>>> unzip (Just ("Hello", "World"))
(Just "Hello",Just "World")
>>> unzip [("I", "love"), ("really", "haskell")]
(["I","really"],["love","haskell"])
Since: base-4.19.0.0
void :: Functor f => f a -> f () Source
void value игнорирует результат вычисления, такой как возвращаемое значение действия IO.
Примеры
Заменить содержимое Maybe Int на единицу:
>>> void Nothing Nothing
>>> void (Just 3) Just ()
Заменить содержимое Either Int Int на единицу, что приводит к значению Either Int ():
>>> void (Left 8675309) Left 8675309
>>> void (Right 8675309) Right ()
Заменить каждый элемент списка на единицу:
>>> void [1,2,3] [(),(),()]
Заменить второй элемент пары на единицу:
>>> void (1,2) (1,())
Игнорировать результат действия IO:
>>> mapM print [1,2] 1 2 [(),()]
>>> void $ mapM print [1,2] 1 2
© The University of Glasgow and others
Licensed under a BSD-style license (see top of the page).
https://downloads.haskell.org/~ghc/9.12.1/docs/libraries/base-4.21.0.0-8e62/Data-Functor.html