Ruby/Array/delete

يحذف التابع delete جميع عناصر المصفوفة المساوية لقيمة محددة ثم يعيد آخر عنصر حذفه، أو القيمة nil أو ناتج تطبيق كتلة برمجية محددة إن لم يعثر على أي عنصر لحذفه.

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

 delete(obj) → item or nil
delete(obj) { block } → item or result of block

المعاملات

obj

الكائن المراد حذفه -أينما وجد- في المصفوفة المعطاة.

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

تعاد المصفوفة نفسها المعطاة بعد حذف العناصر المساوي للوسيط obj منها، أو تعاد القيمة nil إن لم يعثر على عنصر مساوٍ للوسيط obj لحذفه، أو يعاد ناتج تنفيذ الكتلة block (إن أعطيت) إن لم يعثر على عنصر مساوٍ للوسيط obj لحذفه.

أمثلة

أمثلة على استخدام التابع delete:

 a = [ "a", "b", "b", "b", "c" ]
a.delete("b")                   #=> "b"
a                               #=> ["a", "c"]
a.delete("z")                   #=> nil
a.delete("z") { "not found" }   #=> "not found"

انظر أيضًا

• التابع delete_at: يحذف عنصرًا ذا فهرس محدد من مصفوفة.
• التابع delete_if: يحذف جميع عناصر المصفوفة التي تعيد الكتلة البرمجية المعطاة القيمة true عند تطبيقها على كل عنصر منها.
• التابع drop: يحذف أول n عنصر من مصفوفة ثمَّ يضع بقية العناصر في مصفوفة جديدة ويعيدها.
• التابع keep_if: يبقي جميع عناصر المصفوفة التي تحقق شرطًا معينًا ويحذف العناصر الأخرى المتبقية.
• التابع reject!‎: يحذف جميع عناصر المصفوفة التي لم تحقق شرطًا محددًا.
• التابع compact!‎: يحذف كل العناصر التي تساوي nil من المصفوفة التي استدعيت معه ثم يعيدها.

مصادر

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