الفرق بين المراجعتين ل"Ruby/Hash/fetch values"

من موسوعة حسوب
< Ruby‏ | Hash
اذهب إلى التنقل اذهب إلى البحث
(إنشاء الصفحة.)
 
(إضافة محتويات الصفحة.)
 
سطر 3: سطر 3:
 
[[تصنيف: Ruby Method]]
 
[[تصنيف: Ruby Method]]
 
[[تصنيف: Ruby Hash]]
 
[[تصنيف: Ruby Hash]]
يعيد التابع <code>fetch_values</code> ت
+
يعيد التابع <code>fetch_values</code> مصفوفة تحتوي على القيم المقترنة بالمفاتيح المعطاة. يرمى الاستثناء <code>[[Ruby/KeyError|KeyError]]</code> عند تعذر العثور على أحد المفاتيح.
 
==البنية العامة==
 
==البنية العامة==
 
<syntaxhighlight lang="ruby">fetch_values(key, ...) → array
 
<syntaxhighlight lang="ruby">fetch_values(key, ...) → array
 
fetch_values(key, ...) { |key| block } → array</syntaxhighlight>
 
fetch_values(key, ...) { |key| block } → array</syntaxhighlight>
 
==المعاملات==
 
==المعاملات==
 +
 +
=== <code>key</code> ===
 +
المفتاح الذي يراد جلب القيمة المقترنة به.
 +
 +
=== <code>...</code> ===
 +
المفاتيح الأخرى المراد جلب القيم المقترنة بها.
  
 
==القيمة المعادة==
 
==القيمة المعادة==
تعاد  
+
تعاد مصفوفة تحتوي على القيم المقترنة بالمفاتيح <code>key</code> و <code>...</code> المعطاة. يرمى الاستثناء <code>[[Ruby/KeyError|KeyError]]</code> عند تعذر العثور على أحد المفاتيح.
 +
 
 +
== أمثلة ==
 +
مثال على استعمال التابع <code>fetch_values</code>:<syntaxhighlight lang="ruby">
 +
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"]
 +
</syntaxhighlight>
 
==انظر أيضا==
 
==انظر أيضا==
*  
+
* التابع <code>[[Ruby/Hash/fetch|fetch]]</code>: يعيد قيمة من الكائن <code>[[Ruby/Hash|Hash]]</code> لمفتاح معين.
  
 
==مصادر==
 
==مصادر==
 
*[http://ruby-doc.org/core-2.5.1/Hash.html#method-i-fetch_values قسم التابع fetch_values في الصنف Hash في توثيق روبي الرسمي.]
 
*[http://ruby-doc.org/core-2.5.1/Hash.html#method-i-fetch_values قسم التابع fetch_values في الصنف Hash في توثيق روبي الرسمي.]

المراجعة الحالية بتاريخ 13:19، 26 نوفمبر 2018

يعيد التابع 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"]

انظر أيضا

  • التابع fetch: يعيد قيمة من الكائن Hash لمفتاح معين.

مصادر