التابع Hash.store في روبي
يربط التابع store قيمة محددة مع مفتاح محدد في الكائن Hash الذي استدعي معه. إن كان المفتاح موجود مسبقًا وكان مرتبط بقيمة، فستتغير هذه القيمة إلى القيمة المعطاة الجديدة. وإن لم يكن موجودًا، فسيُنشَأ ويُربَط بالقيمة المعطاة ويضاف إلى الكائن.
البنية العامة
store(key, value) → value
المعاملات
key
المفتاح الذي يراد ربط القيمة value المعطاة به.
value
القيمة التي ستُربَط بالمفتاح key.
القيمة المعادة
تعاد القيمة value نفسها بعد ربطها بالمفتاح key.
أمثلة
مثال على استعمال التابع store:
h = { "a" => 100, "b" => 200 }
h["a"] = 9
h["c"] = 4
h #=> {"a"=>9, "b"=>200, "c"=>4}
h.store("d", 42) #=> 42
h #=> {"a"=>9, "b"=>200, "c"=>4, "d"=>42}
انتبه إلى أنَّه لا يجب تغيير قيمة كائنٍ أثناء استخدامه كمفتاح، إذ ستكرر السلاسل النصية غير المجمدة المستعملة كمفتاح وتُجمَّد. اطلع على المثال التالي الذي يشرح ذلك:
a = "a"
b = "b".freeze
h = { a => 100, b => 200 }
h.key(100).equal? a #=> false
h.key(200).equal? b #=> true
انظر أيضا
- المعامل
[]: يربط عند استدعائه بالشكلhsh[key] = valueالقيمةvalueالمعطاة بالمفتاحkeyفي الجدولHash. - التابع
key: يعيد المفتاح المقابل لقيمة معيَّنة في الكائنHashالذي استدعي معه.