الفرق بين المراجعتين لصفحة: «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"]