Exception: StopIteration

Inherits:
IndexError show all
Defined in:
enumerator.c,
enumerator.c

Overview

Raised to stop the iteration, in particular by Enumerator#next. It is rescued by Kernel#loop.

loop do
  puts "Hello"
  raise StopIteration
  puts "World"
end
puts "Done!"

produces:

Hello
Done!

Direct Known Subclasses

ClosedQueueError, Ractor::ClosedError

Instance Method Summary collapse

Methods inherited from Exception

#==, #backtrace, #backtrace_locations, #cause, #exception, exception, #full_message, #initialize, #inspect, #message, #set_backtrace, #to_s, to_tty?

Constructor Details

This class inherits a constructor from Exception

Instance Method Details

#resultObject

Returns the return value of the iterator.

o = Object.new
def o.each
  yield 1
  yield 2
  yield 3
  100
end

e = o.to_enum

puts e.next                   #=> 1
puts e.next                   #=> 2
puts e.next                   #=> 3

begin
  e.next
rescue StopIteration => ex
  puts ex.result              #=> 100
end

2839
2840
2841
2842
2843
# File 'enumerator.c', line 2839

static VALUE
stop_result(VALUE self)
{
    return rb_attr_get(self, id_result);
}