الفرق بين المراجعتين ل"Ruby/Hash/fetch values"
اذهب إلى التنقل
اذهب إلى البحث
جميل-بيلوني (نقاش | مساهمات) (إنشاء الصفحة.) |
جميل-بيلوني (نقاش | مساهمات) (إضافة محتويات الصفحة.) |
||
سطر 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"]