Delete Ractor.receive_if

Author: soutaro

core/ractor.rbs

@@ -350,68 +350,6 @@ class Ractor
   #
   def self.receive: () -> untyped
 
-  # <!--
-  #   rdoc-file=ractor.rb
-  #   - Ractor.receive_if {|msg| block } -> msg
-  # -->
-  # Receive only a specific message.
-  #
-  # Instead of Ractor.receive, Ractor.receive_if can be given a pattern (or any
-  # filter) in a block and you can choose the messages to accept that are
-  # available in your ractor's incoming queue.
-  #
-  #     r = Ractor.new do
-  #       p Ractor.receive_if{|msg| msg.match?(/foo/)} #=> "foo3"
-  #       p Ractor.receive_if{|msg| msg.match?(/bar/)} #=> "bar1"
-  #       p Ractor.receive_if{|msg| msg.match?(/baz/)} #=> "baz2"
-  #     end
-  #     r << "bar1"
-  #     r << "baz2"
-  #     r << "foo3"
-  #     r.take
-  #
-  # This will output:
-  #
-  #     foo3
-  #     bar1
-  #     baz2
-  #
-  # If the block returns a truthy value, the message is removed from the incoming
-  # queue and returned. Otherwise, the message remains in the incoming queue and
-  # the next messages are checked by the given block.
-  #
-  # If there are no messages left in the incoming queue, the method will block
-  # until new messages arrive.
-  #
-  # If the block is escaped by break/return/exception/throw, the message is
-  # removed from the incoming queue as if a truthy value had been returned.
-  #
-  #     r = Ractor.new do
-  #       val = Ractor.receive_if{|msg| msg.is_a?(Array)}
-  #       puts "Received successfully: #{val}"
-  #     end
-  #
-  #     r.send(1)
-  #     r.send('test')
-  #     wait
-  #     puts "2 non-matching sent, nothing received"
-  #     r.send([1, 2, 3])
-  #     wait
-  #
-  # Prints:
-  #
-  #     2 non-matching sent, nothing received
-  #     Received successfully: [1, 2, 3]
-  #
-  # Note that you can not call receive/receive_if in the given block recursively.
-  # You should not do any tasks in the block other than message filtration.
-  #
-  #     Ractor.current << true
-  #     Ractor.receive_if{|msg| Ractor.receive}
-  #     #=> `receive': can not call receive/receive_if recursively (Ractor::Error)
-  #
-  def self.receive_if: () { (untyped) -> boolish } -> untyped
-
   # <!--
   #   rdoc-file=ractor.rb
   #   - recv()

test/stdlib/Ractor_test.rb

@@ -73,14 +73,6 @@ def test_recv
                      Ractor, :recv
   end
 
-  def test_receive_if
-    omit "Ractor.receive_if is not implemented" if RUBY_VERSION >= "3.5"
-
-    Ractor.current.send 42
-    assert_send_type "() { (Integer) -> bool } -> Integer",
-                     Ractor, :receive_if do |n| n == 42 end
-  end
-
   def test_select
     omit "Ractor#yield is not implemented" if RUBY_VERSION >= "3.5"
 
@@ -160,7 +152,7 @@ def test_aset
 
   def test_close_incoming
     omit "Ractor#close_incoming is not implemented" if RUBY_VERSION >= "3.5"
-    
+
     r = Ractor.new {}
     assert_send_type "() -> bool",
                      r, :close_incoming