instance method · added in Ruby 4.0

Ractor#join

() -> self

ractor.join → self

# File tmp/rubies/ruby-4.0.0/ractor.rb, line 585
def join
  port = Port.new

  self.monitor port
  if port.receive == :aborted
    __builtin_ractor_value
  end

  self
ensure
  port.close
end

Waits for the termination of the Ractor. If the Ractor was aborted (terminated by an unhandled exception), the exception is raised in the current ractor.

Example

Ractor.new{}.join #=> ractor

Ractor.new{ raise "foo" }.join
#=> raises the exception "foo (RuntimeError)"

Ruby version changes

4.0
- Ractor#join and Ractor#value were added to wait for the termination of a Ractor. These are similar to Thread#join and Thread#value.
- Ractor#monitor and Ractor#unmonitor were added as low-level interfaces used internally to implement Ractor#join.

See also #inspect #monitor #default_port #name also in 4.1

‹ prev#inspect next ›#monitor