Optics.Getter

A Getter is simply a function considered as an Optic.

Given a function f :: S -> A, we can convert it into a Getter S A using to, and convert back to a function using view.

This is typically useful not when you have functions/Getters alone, but when you are composing multiple Optics to produce a Getter.

Formation

type Getter s a = Optic' A_Getter NoIx s a

Type synonym for a getter.

Introduction

to :: (s -> a) -> Getter s a

Build a getter from a function.

Elimination

view :: Is k A_Getter => Optic' k is s a -> s -> a

View the value pointed to by a getter.

If you want to view a type-modifying optic that is insufficiently polymorphic to be type-preserving, use getting.

views :: Is k A_Getter => Optic' k is s a -> (a -> r) -> s -> r

View the function of the value pointed to by a getter.

Computation

view (to f) ≡ f

Well-formedness

A Getter is not subject to any laws.

Subtyping

data A_Getter :: OpticKind

Tag for a getter.

Instances

ReversibleOptic A_Getter

Defined in Optics.Re

Associated Types

type ReversedOptic A_Getter = (r :: Type)

Methods

re :: AcceptsEmptyIndices "re" is => Optic A_Getter is s t a b -> Optic (ReversedOptic A_Getter) is b a t s

Is A_Getter A_Fold

Defined in Optics.Internal.Optic.Subtyping

Methods

implies :: proxy A_Getter A_Fold p -> (Constraints A_Getter p -> r) -> Constraints A_Fold p -> r

Is A_Getter An_AffineFold

Defined in Optics.Internal.Optic.Subtyping

Methods

implies :: proxy A_Getter An_AffineFold p -> (Constraints A_Getter p -> r) -> Constraints An_AffineFold p -> r

Is A_ReversedPrism A_Getter

Defined in Optics.Internal.Optic.Subtyping

Methods

implies :: proxy A_ReversedPrism A_Getter p -> (Constraints A_ReversedPrism p -> r) -> Constraints A_Getter p -> r

Is A_Lens A_Getter

Defined in Optics.Internal.Optic.Subtyping

Methods

implies :: proxy A_Lens A_Getter p -> (Constraints A_Lens p -> r) -> Constraints A_Getter p -> r

Is An_Iso A_Getter

Defined in Optics.Internal.Optic.Subtyping

Methods

implies :: proxy An_Iso A_Getter p -> (Constraints An_Iso p -> r) -> Constraints A_Getter p -> r

(s ~ t, a ~ b) => ToReadOnly A_Getter s t a b

Defined in Optics.ReadOnly

Methods

getting :: Optic A_Getter is s t a b -> Optic' (Join A_Getter A_Getter) is s a

(s ~ t, a ~ b) => IxOptic A_Getter s t a b

Defined in Optics.Indexed.Core

Methods

noIx :: NonEmptyIndices is => Optic A_Getter is s t a b -> Optic A_Getter NoIx s t a b

type ReversedOptic A_Getter

Defined in Optics.Re

type ReversedOptic A_Getter = A_Review