التابع Hash.delete في روبي
يحذف التابع 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"