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

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

يحذف التابع 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 المعطى.

مصادر

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

@@ سطر 3: / سطر 3: @@
 [[تصنيف: Ruby Method]]
 [[تصنيف: Ruby Hash]]
-يعيد التابع <code>delete</code> ت
+يحذف التابع <code>delete</code> زوجًا ذا مفتاح محدَّد ويعيد قيمته من الكائن <code>[[Ruby/Hash|Hash]]</code> الذي استدعي معه. يُعيد التابع القيمة <code>nil</code> إذا كان المفتاح غير موجود. إذا أعطيت الكتلة الاختيارية وكان المفتاح غير موجود، فسيُمرَّر المفتاح إليها ويعاد ناتج تنفيذها.
 ==البنية العامة==
 <syntaxhighlight lang="ruby">delete(key) → value
 delete(key) {| key | block } → value</syntaxhighlight>
 ==المعاملات==
+=== <code>key</code> ===
+المفتاح المراد حذفه هو والقيمة المرتبطة به من الكائن <code>[[Ruby/Hash|Hash]]</code> المعطى.
 ==القيمة المعادة==
-تعاد
+تعاد القيمة المرتبطة بالمفتاح <code>key</code> بعد حذفهما من الكائن <code>[[Ruby/Hash|Hash]]</code> المعطى، أو تعاد القيمة <code>nil</code> أو ناتج تنفيذ الكتلة <code>block</code> إن أعطيت بعد تمرير المفتاح <code>key</code> إليها إن لم يُعثَر عليه.
+== أمثلة ==
+مثال على استعمال التابع <code>delete</code>:<syntaxhighlight lang="ruby">
+h = { "a" => 100, "b" => 200 }
+h.delete("a")                              #=> 100
+h.delete("z")                              #=> nil
+h.delete("z") { |el| "#{el} not found" }   #=> "z not found"
+</syntaxhighlight>
 ==انظر أيضا==
-*
+* التابع <code>[[Ruby/Hash/clear|clear]]</code>: يزيل جميع الأزواج قيمة-مفتاح من الكائن <code>[[Ruby/Hash|Hash]]</code> الذي استدعي معه.
+* التابع <code>[[Ruby/Hash/delete if|delete_if]]</code>: يحذف كل زوج قيمة-مفتاح يحقق شرطًا معيَّنًا من أزواج الكائن <code>[[Ruby/Hash|Hash]]</code> المعطى.
 ==مصادر==
 *[http://ruby-doc.org/core-2.5.1/Hash.html#method-i-delete قسم التابع delete في الصنف Hash في توثيق روبي الرسمي.]