Ruby Enumerator类用法及代码示例

允许内部和外部迭代的类。

Enumerator 可以通过以下方法创建。

• Object.to_enum

• Object.enum_for

• Enumerator.new

大多数方法有两种形式：一种为枚举中的每个项目评估内容的块形式，以及一种返回包装迭代的新 Enumerator 的非块形式。

enumerator = %w(one two three).each
puts enumerator.class # => Enumerator

enumerator.each_with_object("foo") do |item, obj|
  puts "#{obj}: #{item}"
end

# foo: one
# foo: two
# foo: three

enum_with_obj = enumerator.each_with_object("foo")
puts enum_with_obj.class # => Enumerator

enum_with_obj.each do |item, obj|
  puts "#{obj}: #{item}"
end

# foo: one
# foo: two
# foo: three

这允许您将枚举器链接在一起。例如，您可以通过以下方式将列表的元素映射到包含索引和元素的字符串：

puts %w[foo bar baz].map.with_index { |w, i| "#{i}:#{w}" }
# => ["0:foo", "1:bar", "2:baz"]

Enumerator 也可以用作外部迭代器。例如， Enumerator#next 返回迭代器的下一个值，如果 Enumerator 在末尾，则引发 StopIteration 。

e = [1,2,3].each   # returns an enumerator object.
puts e.next   # => 1
puts e.next   # => 2
puts e.next   # => 3
puts e.next   # raises StopIteration

请注意，next、next_values、peek 和 peek_values 的枚举序列不会影响其他非外部枚举方法，除非底层迭代方法本身有副作用，例如 IO#each_line 。

此外，实现通常使用纤程，因此性能可能会更慢，并且异常堆栈跟踪与预期不同。

您可以使用它来实现内部迭代器，如下所示：

def ext_each(e)
  while true
    begin
      vs = e.next_values
    rescue StopIteration
      return $!.result
    end
    y = yield(*vs)
    e.feed y
  end
end

o = Object.new

def o.each
  puts yield
  puts yield(1)
  puts yield(1, 2)
  3
end

# use o.each as an internal iterator directly.
puts o.each {|*x| puts x; [:b, *x] }
# => [], [:b], [1], [:b, 1], [1, 2], [:b, 1, 2], 3

# convert o.each to an external iterator for
# implementing an internal iterator.
puts ext_each(o.to_enum) {|*x| puts x; [:b, *x] }
# => [], [:b], [1], [:b, 1], [1, 2], [:b, 1, 2], 3