Elixir Enum.min用法及代码示例

@spec min(t(), (element(), element() -> boolean()) | module(), (() -> empty_result)) ::
  element() | empty_result
when empty_result: any()

根据 Erlang 的术语排序返回 enumerable 中的最小元素。

默认情况下，比较是使用<= 排序器函数完成的。如果多个元素被认为是最小的，则返回找到的第一个元素。如果您希望返回被认为是最小的最后一个元素，则 sorter 函数不应为相等的元素返回 true。

如果可枚举为空，则调用提供的empty_fallback。默认的 empty_fallback 引发 Enum.EmptyError 。

例子

iex> Enum.min([1, 2, 3])
1

这个函数使用 Erlang 的术语排序这一事实意味着比较是结构化的而不是语义的。例如：

iex> Enum.min([~D[2017-03-31], ~D[2017-04-01]])
~D[2017-04-01]

在上面的示例中， min/2 返回 4 月 1 日而不是 3 月 31 日，因为结构比较比较的是前一天。出于这个原因，大多数结构都提供了一个"compare"函数，例如 Date.compare/2 ，它接收两个结构并返回:lt(小于)、:eq(等于)和:gt(大于)。如果你传递一个模块作为排序函数，Elixir 会自动使用该模块的compare/2 函数：

iex> Enum.min([~D[2017-03-31], ~D[2017-04-01]], Date)
~D[2017-03-31]

最后，如果您不想引发空枚举，则可以传递空回退：

iex> Enum.min([], fn -> 0 end)
0