IO: timeout / timeout= / wait_priority と IO::TimeoutError を追加 (Ruby 3.2)

いずれも Ruby 3.2 で追加されたもの。実機で確認し版分岐した。

  IO#timeout          設定されている入出力タイムアウトの取得
  IO#timeout=         入出力タイムアウトの設定
  IO#wait_priority    優先データの読み込み待ち
  IO::TimeoutError    タイムアウト時に発生する例外 (< IOError)

トラッカーでは IO#timeout= だけが未収録扱いだったが、getter の IO#timeout も
未収録だった (timeout ライブラリの Kernel#timeout と名前が衝突して収録済みと
誤検出されていた)。getter/setter の対として両方追加した。

IO::TimeoutError は IO.md が front matter に include を持つため同居できない
(multiple entities in a file with front matter relations になる)。
IO__Buffer 系の例外と同じく IO__TimeoutError.md として独立ファイルにし、
版の出し分けは front matter の since: "3.2" で行った。

IO#timeout の既定値が nil、設定すると値を返すこと、タイムアウト時に
IO::TimeoutError が発生することを実機で確認した。wait_priority の引数と
返り値 (真、またはタイムアウト時 nil) も実機と rdoc で確認済み。

bitclust のデータベース生成を 3.1 / 3.2 / 3.3 / 4.0 で実行してエラーが出ないこと、
登録される項目が 0 / 4 / 4 / 4 件と 3.2 追加どおりになること、および
IO#wait_readable などの参照リンクが解決することを確認済み。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

Author: Watson1978

manual/api/_builtin/IO.md

@@ -2431,6 +2431,60 @@ p IO.new(IO.sysopen("/")).path               # => "/"
 p IO.new(IO.sysopen("/"), path: "foo").path  # => "foo"
 ```
 
+### def timeout -> Numeric | nil
+
+self に設定されている入出力のタイムアウトを返します。
+設定されていない場合は nil を返します。
+
+タイムアウトの設定については [m:IO#timeout=] を参照してください。
+
+```ruby title="例"
+r, w = IO.pipe
+p r.timeout      # => nil
+r.timeout = 0.5
+p r.timeout      # => 0.5
+```
+
+- **SEE** [m:IO#timeout=]
+
+### def timeout=(numeric) -> Numeric
+### def timeout=(nil) -> nil
+
+self に入出力のタイムアウトを秒単位で設定します。
+
+設定すると、可能な限りすべてのブロッキング操作にこのタイムアウトが適用されます。
+操作が設定した時間を超えると [c:IO::TimeoutError] が発生します。
+
+影響を受けるのは [m:IO#gets]、[m:IO#puts]、[m:IO#read]、[m:IO#write]、
+[m:IO#wait_readable]、[m:IO#wait_writable] などです
+([c:Socket] のブロッキング操作にも影響します)。
+
+- **param** `numeric` -- タイムアウトの秒数を数値で指定します。
+             nil を指定するとタイムアウトを解除します。
+
+```ruby title="例"
+r, w = IO.pipe
+r.timeout = 0.1
+
+r.read # ~> IO::TimeoutError
+```
+
+- **SEE** [m:IO#timeout], [c:IO::TimeoutError]
+
+### def wait_priority(timeout = nil) -> bool | self | nil
+
+self が優先データを受信して読み込み可能になるまで待ちます。
+
+優先データ(緊急データ)は [m:Socket::Constants::MSG_OOB] フラグを用いて
+送受信され、通常はストリーム型のソケットに限られます。
+
+- **param** `timeout` -- タイムアウトを秒単位の数値で指定します。
+             nil を指定すると読み込み可能になるまで待ち続けます。
+- **return** -- 読み込み可能になった場合は真を、timeout で指定した時間が経過した
+        場合は nil を返します。
+
+- **SEE** [m:IO#wait_readable], [m:IO#wait_writable]
+
 #@end
 
 ## Constants

manual/api/_builtin/IO__TimeoutError.md

@@ -0,0 +1,16 @@
+---
+library: _builtin
+since: "3.2"
+---
+# class IO::TimeoutError < IOError
+
+入出力の操作が [m:IO#timeout=] で設定した時間を超えたときに発生します。
+
+```ruby
+r, w = IO.pipe
+r.timeout = 0.1
+
+r.read # ~> IO::TimeoutError
+```
+
+- **SEE** [m:IO#timeout=], [m:IO#timeout]