التابع Hash.fetch_values في روبي
يعيد التابع fetch_values مصفوفة تحتوي على القيم المقترنة بالمفاتيح المعطاة. يرمى الاستثناء KeyError عند تعذر العثور على أحد المفاتيح.
البنية العامة
fetch_values(key, ...) → array
fetch_values(key, ...) { |key| block } → array
المعاملات
key
المفتاح الذي يراد جلب القيمة المقترنة به.
...
المفاتيح الأخرى المراد جلب القيم المقترنة بها.
القيمة المعادة
تعاد مصفوفة تحتوي على القيم المقترنة بالمفاتيح key و ... المعطاة. يرمى الاستثناء KeyError عند تعذر العثور على أحد المفاتيح.
أمثلة
مثال على استعمال التابع fetch_values:
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"]