模組 Stdlib.Either

module Either: Either

type ('a, 'b) t =

`\|`	`Left of 'a`
`\|`	`Right of 'b`

類型為 ('a, 'b) Either.t 的值，包含一個 'a 類型的值或一個 'b 類型的值

val left : 'a -> ('a, 'b) t

left v 是 Left v。

val right : 'b -> ('a, 'b) t

right v 是 Right v。

val is_left : ('a, 'b) t -> bool

is_left (Left v) 為 true，is_left (Right v) 為 false。

val is_right : ('a, 'b) t -> bool

is_right (Left v) 為 false，is_right (Right v) 為 true。

val find_left : ('a, 'b) t -> 'a option

find_left (Left v) 為 Some v，find_left (Right _) 為 None。

val find_right : ('a, 'b) t -> 'b option

find_right (Right v) 為 Some v，find_right (Left _) 為 None。

val map_left : ('a1 -> 'a2) -> ('a1, 'b) t -> ('a2, 'b) t

如果 e 是 Left v，則 map_left f e 為 Left (f v)，如果 e 是 Right _，則為 e。

val map_right : ('b1 -> 'b2) -> ('a, 'b1) t -> ('a, 'b2) t

如果 e 是 Right v，則 map_right f e 為 Right (f v)，如果 e 是 Left _，則為 e。

val map : left:('a1 -> 'a2) ->
       right:('b1 -> 'b2) -> ('a1, 'b1) t -> ('a2, 'b2) t

map ~left ~right (Left v) 為 Left (left v)，map ~left ~right (Right v) 為 Right (right v)。

val fold : left:('a -> 'c) -> right:('b -> 'c) -> ('a, 'b) t -> 'c

fold ~left ~right (Left v) 為 left v，而 fold ~left ~right (Right v) 為 right v。

val iter : left:('a -> unit) -> right:('b -> unit) -> ('a, 'b) t -> unit

iter ~left ~right (Left v) 為 left v，而 iter ~left ~right (Right v) 為 right v。

val for_all : left:('a -> bool) -> right:('b -> bool) -> ('a, 'b) t -> bool

for_all ~left ~right (Left v) 為 left v，而 for_all ~left ~right (Right v) 為 right v。

val equal : left:('a -> 'a -> bool) ->
       right:('b -> 'b -> bool) -> ('a, 'b) t -> ('a, 'b) t -> bool

equal ~left ~right e0 e1 使用 left 和 right 分別比較 Left _ 和 Right _ 包裹的值，來測試 e0 和 e1 是否相等。

val compare : left:('a -> 'a -> int) ->
       right:('b -> 'b -> int) -> ('a, 'b) t -> ('a, 'b) t -> int

compare ~left ~right e0 e1 使用 left 和 right 分別比較 Left _ 和 Right _ 包裹的值，來完全排序 e0 和 e1。Left _ 的值小於 Right _ 的值。