package base

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

Source file either_intf.ml

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
(** A type that represents values with two possibilities.

    [Either] can be seen as a generic sum type, the dual of [Tuple].  [First] is neither
    more important nor less important than [Second].

    Many functions in [Either] focus on just one constructor.  The [Focused] signature
    abstracts over which constructor is the focus.  To use these functions, use the
    [First] or [Second] modules in [S].  *)

open! Import

module type Focused = sig
  type (+'focus, +'other) t

  include Monad.S2             with type ('a, 'b) t := ('a, 'b) t
  include Applicative.S2       with type ('a, 'b) t := ('a, 'b) t

  module Args : Applicative.Args2 with type ('a, 'e) arg := ('a, 'e) t
    [@@warning "-3"]
  [@@deprecated "[since 2018-09] Use [ppx_let] instead."]

  val value : ('a, _) t -> default:'a -> 'a

  val to_option : ('a, _) t -> 'a option

  val with_return : ('a With_return.return -> 'b) -> ('a, 'b) t

  val combine
    :  ('a, 'd) t
    -> ('b, 'd) t
    -> f:('a -> 'b -> 'c)
    -> other:('d -> 'd -> 'd)
    -> ('c, 'd) t

  val combine_all : ('a, 'b) t list -> f:('b -> 'b -> 'b) -> ('a list, 'b) t

  val combine_all_unit : (unit, 'b) t list -> f:('b -> 'b -> 'b) -> (unit, 'b) t
end

module type Either = sig

  type ('f, 's) t =
    | First  of 'f
    | Second of 's
  [@@deriving_inline compare, hash, sexp]
  include
  sig
    [@@@ocaml.warning "-32"]
    val compare :
      ('f -> 'f -> int) ->
      ('s -> 's -> int) -> ('f, 's) t -> ('f, 's) t -> int
    val hash_fold_t :
      (Ppx_hash_lib.Std.Hash.state -> 'f -> Ppx_hash_lib.Std.Hash.state) ->
      (Ppx_hash_lib.Std.Hash.state -> 's -> Ppx_hash_lib.Std.Hash.state) ->
      Ppx_hash_lib.Std.Hash.state ->
      ('f, 's) t -> Ppx_hash_lib.Std.Hash.state
    include Ppx_sexp_conv_lib.Sexpable.S2 with type ('f,'s) t :=  ('f, 's) t
  end[@@ocaml.doc "@inline"]
  [@@@end]

  include Invariant.S2 with type ('a, 'b) t := ('a, 'b) t

  val swap      : ('f, 's) t -> ('s, 'f) t

  val value     : ('a, 'a) t -> 'a

  val iter      : ('a, 'b) t -> first:('a -> unit) -> second:('b -> unit) -> unit
  val value_map : ('a, 'b) t -> first:('a -> 'c)   -> second:('b -> 'c)   -> 'c
  val map       : ('a, 'b) t -> first:('a -> 'c)   -> second:('b -> 'd)   -> ('c, 'd) t

  val equal : ('f -> 'f -> bool) -> ('s -> 's -> bool) -> ('f, 's) t -> ('f, 's) t -> bool

  module type Focused = Focused

  module First  : Focused with type ('a, 'b) t = ('a, 'b) t
  module Second : Focused with type ('a, 'b) t = ('b, 'a) t

  val is_first  : (_, _) t -> bool
  val is_second : (_, _) t -> bool

  (** [first] and [second] are [First.return] and [Second.return]. *)
  val first     : 'f -> ('f, _) t
  val second    : 's -> (_, 's) t

  (**/**)

  module Export : sig
    type ('f, 's) _either
      = ('f, 's) t
      = First  of 'f
      | Second of 's
  end
end