From 9c6022ba429df8752ab0e605fa7ffbf97d77c1b2 Mon Sep 17 00:00:00 2001
From: Kouhei Yanagita <yanagi@shakenbu.org>
Date: Thu, 26 Dec 2024 10:37:50 +0900
Subject: [PATCH] =?UTF-8?q?Array#fetch=5Fvalues=E3=82=92=E8=BF=BD=E5=8A=A0?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 refm/api/src/_builtin/Array | 27 +++++++++++++++++++++++++++
 1 file changed, 27 insertions(+)

diff --git a/refm/api/src/_builtin/Array b/refm/api/src/_builtin/Array
index 9c75a7161..f1a6bcba4 100644
--- a/refm/api/src/_builtin/Array
+++ b/refm/api/src/_builtin/Array
@@ -1082,6 +1082,33 @@ result = a.fetch(10){|nth|
 p result #=> 999
 #@end
 
+#@since 3.4
+--- fetch_values(*indexes)                 -> Array
+--- fetch_values(*indexes) { |index| ... } -> Array
+
+引数で指定されたインデックスに対する値の配列を返します。
+
+指定したインデックスが self の範囲外である場合、ブロックが与えられたかどうかにより挙動が異なります。
+
+ * ブロックが与えられている場合、インデックスを引数としてブロックを呼び出し、その結果の値を使用します。
+ * ブロックが与えられていない場合、[[c:IndexError]] が発生します。
+
+@param indexes 取得したい要素のインデックスを指定します。
+
+@raise IndexError ブロックが与えられてない時に、範囲外のインデックスを引数で指定すると発生します。
+
+#@samplecode 例
+ary = ["a", "b", "c"]
+
+ary.fetch_values(0, 2)  # => ["a", "c"]
+ary.fetch_values(-1, 1) # => ["d", "b"]
+ary.fetch_values(0, 10) # => index 10 outside of array bounds: -4...4 (IndexError)
+ary.fetch_values(0, 10) { |i| i.to_s } # => ["a", "10"]
+#@end
+
+@see [[m:Array#values_at]], [[m:Array#fetch]]
+#@end
+
 --- fill(val)            -> self
 --- fill {|index| ... }  -> self