التابع Hash.store في روبي

من موسوعة حسوب
< Ruby‏ | Hash
اذهب إلى التنقل اذهب إلى البحث

يربط التابع 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 الذي استدعي معه.

مصادر