summaryrefslogtreecommitdiff
path: root/hash.c
diff options
context:
space:
mode:
authornobu <nobu@b2dd03c8-39d4-4d8f-98ff-823fe69b080e>2015-06-12 08:34:17 (GMT)
committernobu <nobu@b2dd03c8-39d4-4d8f-98ff-823fe69b080e>2015-06-12 08:34:17 (GMT)
commit86eaa24570a7a062cf8f08606256e0cd23d2b980 (patch)
tree740126dbac52681afc6d8355f64fe67ae40a8c35 /hash.c
parentc54fb9ec8b7d7dc90e2083aada6dc9e472f21679 (diff)
hash.c: fetch_values
* hash.c (rb_hash_fetch_values): add `Hash#fetch_values`. [Feature #10017] [Fix GH-776] git-svn-id: svn+ssh://ci.ruby-lang.org/ruby/trunk@50845 b2dd03c8-39d4-4d8f-98ff-823fe69b080e
Diffstat (limited to 'hash.c')
-rw-r--r--hash.c29
1 files changed, 29 insertions, 0 deletions
diff --git a/hash.c b/hash.c
index 60e9807..80de813 100644
--- a/hash.c
+++ b/hash.c
@@ -1275,6 +1275,34 @@ rb_hash_values_at(int argc, VALUE *argv, VALUE hash)
return result;
}
+/*
+ * call-seq:
+ * hsh.fetch_values(key, ...) -> array
+ * hsh.fetch_values(key, ...) { |key| block } -> array
+ *
+ * Returns an array containing the values associated with the given keys
+ * but also raises <code>KeyError</code> when one of keys can't be found.
+ * Also see <code>Hash#values_at</code> and <code>Hash#fetch</code>.
+ *
+ * h = { "cat" => "feline", "dog" => "canine", "cow" => "bovine" }
+ *
+ * h.fetch_values("cow", "cat") #=> ["bovine", "feline"]
+ * h.fetch_values("cow", "bird") # raises KeyError
+ * h.fetch_values("cow", "bird") { |k| k.upcase } #=> ["bovine", "BIRD"]
+ */
+
+VALUE
+rb_hash_fetch_values(int argc, VALUE *argv, VALUE hash)
+{
+ VALUE result = rb_ary_new2(argc);
+ long i;
+
+ for (i=0; i<argc; i++) {
+ rb_ary_push(result, rb_hash_fetch(hash, argv[i]));
+ }
+ return result;
+}
+
static int
select_i(VALUE key, VALUE value, VALUE result)
{
@@ -4001,6 +4029,7 @@ Init_Hash(void)
rb_define_method(rb_cHash,"keys", rb_hash_keys, 0);
rb_define_method(rb_cHash,"values", rb_hash_values, 0);
rb_define_method(rb_cHash,"values_at", rb_hash_values_at, -1);
+ rb_define_method(rb_cHash,"fetch_values", rb_hash_fetch_values, -1);
rb_define_method(rb_cHash,"shift", rb_hash_shift, 0);
rb_define_method(rb_cHash,"delete", rb_hash_delete_m, 1);