lens-4.8: Lenses, Folds and Traversals

Control.Lens.Equality

Description

Synopsis

Type Equality

type Equality s t a b = forall p f. p a (f b) -> p s (f t) Source

A witness that (a ~ s, b ~ t).

Note: Composition with an Equality is index-preserving.

type Equality' s a = Equality s s a a Source

type AnEquality s t a b = Identical a (Identity b) a (Identity b) -> Identical a (Identity b) s (Identity t) Source

When you see this as an argument to a function, it expects an Equality.

type AnEquality' s a = AnEquality s s a a Source

runEq :: AnEquality s t a b -> Identical s t a b Source

Extract a witness of type Equality.

substEq :: AnEquality s t a b -> ((s ~ a, t ~ b) => r) -> r Source

Substituting types with Equality.

mapEq :: AnEquality s t a b -> f s -> f a Source

We can use Equality to do substitution into anything.

fromEq :: AnEquality s t a b -> Equality b a t s Source

Equality is symmetric.

simply :: (Optic' p f s a -> r) -> Optic' p f s a -> r Source

This is an adverb that can be used to modify many other Lens combinators to make them require simple lenses, simple traversals, simple prisms or simple isos as input.

The Trivial Equality

Composition with this isomorphism is occasionally useful when your Lens, Traversal or Iso has a constraint on an unused argument to force that argument to agree with the type of a used argument and avoid ScopedTypeVariables or other ugliness.

Implementation Details

data Identical a b s t where Source

Provides witness that (s ~ a, b ~ t) holds.

Constructors

 Identical :: Identical a b a b