package monads

  1. Overview
  2. Docs
Legend:
Library
Module
Module type
Parameter
Class
Class type

Make2(M) composes the option monad with the monad M.

Parameters

module M : Monad2

Signature

include Trans.S2 with type ('a, 'e) t := ('a, 'e) T2(M).t with type ('a, 'e) m := ('a, 'e) T2(M).m with type ('a, 'e) e := ('a, 'e) T2(M).e
val lift : ('a, 'e) T2(M).m -> ('a, 'e) T2(M).t

lifts inner monad into the resulting monad

val run : ('a, 'e) T2(M).t -> ('a, 'e) T2(M).e

runs the computation

include Monad2 with type ('a, 'e) t := ('a, 'e) T2(M).t
val void : ('a, 'e) T2(M).t -> (unit, 'e) T2(M).t

void m computes m and discrards the result.

val sequence : (unit, 'e) T2(M).t list -> (unit, 'e) T2(M).t

sequence xs computes a sequence of computations xs in the left to right order.

val forever : ('a, 'e) T2(M).t -> ('b, 'e) T2(M).t

forever xs creates a computationt that never returns.

module Fn : sig ... end

Various function combinators lifted into the Kleisli category.

module Pair : sig ... end

The pair interface lifted into the monad.

module Triple : sig ... end

The triple interface lifted into a monad.

module Lift : sig ... end

Lifts functions into the monad.

module Exn : sig ... end

Interacting between monads and language exceptions

module Collection : sig ... end

Lifts collection interface into the monad.

module List : Collection.S with type 'a t := 'a list

The Monad.Collection.S2 interface for lists

module Seq : Collection.S with type 'a t := 'a Core_kernel.Sequence.t

The Monad.Collection.S2 interface for sequences

include Syntax.S2 with type ('a, 'e) t := ('a, 'e) T2(M).t
val (>=>) : ('a -> ('b, 'e) T2(M).t) -> ('b -> ('c, 'e) T2(M).t) -> 'a -> ('c, 'e) T2(M).t

f >=> g is fun x -> f x >>= g

val (!!) : 'a -> ('a, 'e) T2(M).t

!!x is return x

val (!$) : ('a -> 'b) -> ('a, 'e) T2(M).t -> ('b, 'e) T2(M).t

!$f is Lift.unary f

val (!$$) : ('a -> 'b -> 'c) -> ('a, 'e) T2(M).t -> ('b, 'e) T2(M).t -> ('c, 'e) T2(M).t

!$$f is Lift.binary f

val (!$$$) : ('a -> 'b -> 'c -> 'd) -> ('a, 'e) T2(M).t -> ('b, 'e) T2(M).t -> ('c, 'e) T2(M).t -> ('d, 'e) T2(M).t

!$$$f is Lift.ternary f

val (!$$$$) : ('a -> 'b -> 'c -> 'd -> 'e) -> ('a, 's) T2(M).t -> ('b, 's) T2(M).t -> ('c, 's) T2(M).t -> ('d, 's) T2(M).t -> ('e, 's) T2(M).t

!$$$$f is Lift.quaternary f

val (!$$$$$) : ('a -> 'b -> 'c -> 'd -> 'e -> 'f) -> ('a, 's) T2(M).t -> ('b, 's) T2(M).t -> ('c, 's) T2(M).t -> ('d, 's) T2(M).t -> ('e, 's) T2(M).t -> ('f, 's) T2(M).t

!$$$$$f is Lift.quinary f

include Syntax.Let.S2 with type ('a, 'e) t := ('a, 'e) T2(M).t
val let* : ('a, 'e) T2(M).t -> ('a -> ('b, 'e) T2(M).t) -> ('b, 'e) T2(M).t

let* r = f x in b is f x >>= fun r -> b

val and* : ('a, 'e) T2(M).t -> ('b, 'e) T2(M).t -> ('a * 'b, 'e) T2(M).t

monoidal product

val let+ : ('a, 'e) T2(M).t -> ('a -> 'b) -> ('b, 'e) T2(M).t

let+ r = f x in b is f x >>| fun r -> b

val and+ : ('a, 'e) T2(M).t -> ('b, 'e) T2(M).t -> ('a * 'b, 'e) T2(M).t

monoidal product

include Core_kernel.Monad.S2 with type ('a, 'e) t := ('a, 'e) T2(M).t
val (>>=) : ('a, 'e) T2(M).t -> ('a -> ('b, 'e) T2(M).t) -> ('b, 'e) T2(M).t
val (>>|) : ('a, 'e) T2(M).t -> ('a -> 'b) -> ('b, 'e) T2(M).t
module Let_syntax : sig ... end
module Monad_infix : sig ... end

Same as Infix, except the monad type has two arguments. The second is always just passed through.

val bind : ('a, 'e) T2(M).t -> f:('a -> ('b, 'e) T2(M).t) -> ('b, 'e) T2(M).t
val return : 'a -> ('a, _) T2(M).t
val map : ('a, 'e) T2(M).t -> f:('a -> 'b) -> ('b, 'e) T2(M).t
val join : (('a, 'e) T2(M).t, 'e) T2(M).t -> ('a, 'e) T2(M).t
val ignore_m : (_, 'e) T2(M).t -> (unit, 'e) T2(M).t
val all : ('a, 'e) T2(M).t list -> ('a list, 'e) T2(M).t
val all_unit : (unit, 'e) T2(M).t list -> (unit, 'e) T2(M).t
module Let : Syntax.Let.S2 with type ('a, 'e) t := ('a, 'e) T2(M).t

Monadic Binding Operators.

module Syntax : Syntax.S2 with type ('a, 'e) t := ('a, 'e) T2(M).t

Monadic operators, see Monad.Syntax.S2 for more.

include Choice.S2 with type ('a, 'e) t := ('a, 'e) T2(M).t
include Choice.Basic2 with type ('a, 'e) t := ('a, 'e) T2(M).t
val pure : 'a -> ('a, 'e) T2(M).t

pure x creates a computation that results in x.

val accept : 'a -> ('a, 'e) T2(M).t

accept x accepts x as a result of computation. (Same as pure x.

val reject : unit -> ('a, 'e) T2(M).t

reject () rejects the rest of computation sequence, and terminate the computation with the zero result (Same as zero ()

val guard : bool -> (unit, 'e) T2(M).t

guard cond ensures cond is true in the rest of computation. Otherwise the rest of the computation is rejected.

val on : bool -> (unit, 'e) T2(M).t -> (unit, 'e) T2(M).t

on cond x computes x only iff cond is true

val unless : bool -> (unit, 'e) T2(M).t -> (unit, 'e) T2(M).t

unless cond x computes x unless cond is true.

include Plus.S2 with type ('a, 'e) t := ('a, 'e) T2(M).t
val zero : unit -> ('a, 'e) T2(M).t

zero () constructs a zero element

val plus : ('a, 'e) T2(M).t -> ('a, 'e) T2(M).t -> ('a, 'e) T2(M).t

plus x y an associative operation.

include Fail.S2 with type ('a, 'e) t := ('a, 'e) T2(M).t and type 'a error = unit
type 'a error = unit

a type of error

val fail : 'e error -> ('a, 'e) T2(M).t

fail err diverges the computation, possibly providing an extra information in a value of type 'e error.

val catch : ('a, 'e) T2(M).t -> ('e error -> ('a, 'e) T2(M).t) -> ('a, 'e) T2(M).t

catch m f if m diverges with some bottom value err, the f err is a result of the whole computation, otherwise returns m.

OCaml

Innovation. Community. Security.