class method · added in Ruby 4.0

Ractor.shareable_proc

[T] () { (?) [self: nil] -> T } -> ^(?) [self: nil] -> T

[T, S] (self: S) { (?) [self: S] -> T } -> ^(?) [self: S] -> T

Ractor.shareable_proc(self: nil){} → shareable proc

# File tmp/rubies/ruby-4.0.0/ractor.rb, line 667
def self.shareable_proc self: nil
  Primitive.attr! :use_block

  __builtin_cexpr!(%Q{
    ractor_shareable_proc(ec, *LOCAL_PTR(self), false)
  })
end

Returns a shareable copy of the given block’s Proc. The value of self in the Proc will be replaced with the value passed via the self: keyword, or nil if not given.

In a shareable Proc, access to any outer variables if prohibited.

Example

a = 42
Ractor.shareable_proc{ p a }
#=> can not isolate a Proc because it accesses outer variables (a). (ArgumentError)

The value of self in the Proc must be a shareable object.

Example

Ractor.shareable_proc(self: self){}
#=> self should be shareable: main (Ractor::IsolationError)

Ruby version changes

4.0
- Ractor.shareable_proc and Ractor.shareable_lambda are introduced to make shareable Proc or lambda. [Feature #21550], [Feature #21557]

See also .shareable_lambda .store_if_absent .shareable? #<< also in 4.1

‹ prev.shareable_lambda next ›.store_if_absent