Enumerable

包含重复关系操作类的模块,此模快的方法都是通过 each 定义的,所以包含此模块的类必须定义 each 方法。

方法

all?
all? {|item| ... }

当所有的项目都为真时返回 true。若任一项目为伪则返回 false。

使用区块时,则依次以各个元素执行区块的计算,若所有的结果都是真则返回 true,一旦区块返回伪时,立刻返回 false。

p [1,2,3].all? {|v| v > 0}   # => true
p [1,2,3].all? {|v| v > 1}   # => false
any?
any? {|item| ... }

当所有的项目都为伪时返回 false。若任一项目为真则返回 true。

使用区块时,则依次以各个元素执行区块的计算,若所有的结果都是伪则返回 false,一旦区块返回真时,立刻返回 true。

p [1,2,3].any? {|v| v > 3}   # => false
p [1,2,3].any? {|v| v > 1}   # => true
collect {|item| ... }

以数组的形式返回所有区块的计算结果。

find {|item| ... }

依次以各个元素执行区块的计算,返回第一个计算为 true 的项目。若没有项目计算为 true,则返回 nil。

find_all {|item| ... }
select {|item| ... }

依次以各个元素执行区块的计算,将所有计算为 true 的项目以数组形式返回。若没有项目计算为 true,则返回空数组。

include?(val)

当列表中任一项目符合 val == 时,返回 true。

inject([init]) {|result, item| ... }

再执行区块之前,将 init 的初始值和一个 item 确定为参数。在第二次和随后的循环中,将上一次区块的运算结果和下一个 item 作为参数,随后继续执行区块。最后一个 item 也作为参数后,返回最后一次区块运算得出的结果。

如果一个 item 是空的,那么就返回 init 。

如果没有设置参数 init 的初始值,则将第一、第二个 item 传递给区块。假如只有一个 item 被定义的话,那么区块不会被执行,第一个 item 会被返回。如果没有 item 被定义,那么就会返回 nil 。

范例

运算结果:

p [1,2,3,4,5].inject(0) {|result, item| result + item }
  => 15

它等同于下面的代码:

result = 0
[1,2,3,4,5].each {|v| result += v }
p result
=> 15
max

返回最大的项目,前提是所有的项目都能够使用 <=> 方法做比较。

max {|a, b| ... }

依次将各个项目与区块的计算结果比较并返回最大的项目。

要求区块的计算值为:a > b 时计算值为正整数、 a == b 时为 0、a < b 时为负整数。若区块返回非整数数值,则抛出 TypeError 异常。

max_by {|item| ... }

将各个区块的结果计算出来后,返回最大的那个项目,如果参数为空,那么就返回nil。(前提是所有的项目都能够使用 <=> 方法做比较。)

min

返回最小的项目,前提是所有的项目都能够使用 <=> 方法做比较。

min {|a, b| ... }

依次将各个项目与区块的计算结果比较并返回最小的项目。

要求区块的计算值为:a > b 时计算值为正整数、 a == b 时为 0、a < b 时为负整数。若区块返回非整数数值,则抛出 TypeError 异常。

min_by {|item| ... }

将各个区块的结果计算出来后,返回最小的那个项目,如果参数为空,那么就返回nil。(前提是所有的项目都能够使用 <=> 方法做比较。)

sort
sort {|a, b| ... }

将所有项目依照升序排列后,生成并返回包含所有项目的数组。

若没有使用区块,则调用 <=> 比较来进行排序。

若想调用其他非 <=> 的方法进行排序,就使用区块,以区块的计算结果进行排序。要求区块的计算值为:a > b 时计算值为正整数、 a == b 时为 0、a < b 时为负整数。若区块返回非整数数值,则抛出 TypeError 异常。

sort_by {|item| ... }

将所有区块按照计算结果进行升序排列,生成并返回一个包含所有项目的新数组。

to_a
entries

返回包含所有项目的数组。