الفرق بين المراجعتين لصفحة: «Ruby/Hash/store»

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

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

مصادر

قسم التابع store في الصنف Hash في توثيق روبي الرسمي.

@@ سطر 3: / سطر 3: @@
 [[تصنيف: Ruby Method]]
 [[تصنيف: Ruby Hash]]
-يربط التابع <code>store</code> قيمة محددة مع مفتاح محدد في الكائن <code>[[Ruby/Hash|Hash]]</code> الذي استدعي معه. إن كان المفتاح موجود مسبقًا وكان مرتبط بقيمة، فستتغير هذه القيمة إلى القيمة المعطاة الجديدة. وإن لم يكن موجودًا، فسيُنشَأ ويُربَط بالقيمة المعطاة ويضاف إلى الكائن.البنية العامة
+يربط التابع <code>store</code> قيمة محددة مع مفتاح محدد في الكائن <code>[[Ruby/Hash|Hash]]</code> الذي استدعي معه. إن كان المفتاح موجود مسبقًا وكان مرتبط بقيمة، فستتغير هذه القيمة إلى القيمة المعطاة الجديدة. وإن لم يكن موجودًا، فسيُنشَأ ويُربَط بالقيمة المعطاة ويضاف إلى الكائن.
+== البنية العامة ==
 <syntaxhighlight lang="ruby">store(key, value) → value</syntaxhighlight>
 ==المعاملات==