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

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

يحذف التابع delete زوجًا ذا مفتاح محدَّد ويعيد قيمته من الكائن Hash الذي استدعي معه. يُعيد التابع القيمة nil إذا كان المفتاح غير موجود. إذا أعطيت الكتلة الاختيارية وكان المفتاح غير موجود، فسيُمرَّر المفتاح إليها ويعاد ناتج تنفيذها.

البنية العامة

delete(key)  value
delete(key) {| key | block }  value

المعاملات

key

المفتاح المراد حذفه هو والقيمة المرتبطة به من الكائن Hash المعطى.

القيمة المعادة

تعاد القيمة المرتبطة بالمفتاح key بعد حذفهما من الكائن Hash المعطى، أو تعاد القيمة nil أو ناتج تنفيذ الكتلة block إن أعطيت بعد تمرير المفتاح key إليها إن لم يُعثَر عليه.

أمثلة

مثال على استعمال التابع delete:
h = { "a" => 100, "b" => 200 }
h.delete("a")                              #=> 100
h.delete("z")                              #=> nil
h.delete("z") { |el| "#{el} not found" }   #=> "z not found"

انظر أيضا

  • التابع clear: يزيل جميع الأزواج قيمة-مفتاح من الكائن Hash الذي استدعي معه.
  • التابع delete_if: يحذف كل زوج قيمة-مفتاح يحقق شرطًا معيَّنًا من أزواج الكائن Hash المعطى.

مصادر