نتائج البحث

يكرِّر التابع with_object الكتلة المعطاة على كل عنصر من عناصر المُعدِّد الذي استدعي معه مع كائن اعتباطي (الكائن المُمرَّر إليه) ثم يعيد هذا الكائن. إن لم تُعطَ الكتلة، فسيعيد التابع كائنًا جديدًا من النوع Enumerator. البنية العامة with_object(obj) {|(*args), obj| ... } with_object(obj) المعاملات obj الكائن الذي سيُكرَّر مع كل عنصر من عناصر الكائن المعطى. القيمة المعادة يعاد الكائن obj المعطى، أو يعاد كائن جديد من النوع Enumerator إن لم تُعطَ أية كتلة. أمثلة مثال على استعمال التابع with_object: to_three = Enumerator.new do |y| 3.times ...

ينشئ التابع reverse_each مصفوفة مؤقتة تحوي عناصر الكائن القابل للتعداد ثم يمر عليها (يستعملها) بترتيب معاكس. إن لم تُعطَ أية كتلة، فسيعيد التابع كائنًا جديدًا من النوع Enumerator. البنية العامة reverse_each(*args) { |item| block } → enum reverse_each(*args) → an_enumerator المعاملات args الوسائط المراد استعمالها في العملية. القيمة المعادة يعاد ناتج تنفيذ الكتلة block على عناصر الكائن القابل للتعداد بترتيب معاكس بعد وضعها في مصفوفة مؤقتة، أو يعاد كائن جديد من النوع Enumerator. أمثلة مثال على استعمال التابع reverse_each: (1..3).reverse_each { |v| p ...

يحذف التابع drop_while عناصر المصفوفة الأولى التي تحقِّق شرطًا محدَّدًا ثمَّ يعيد مصفوفة جديدة تحوي بقية العناصر. إن لم تمرَّر أيَّة كتلة، فسيعيد التابع drop_while كائنًا من النوع Enumerator. البنية العامة drop_while { |obj| block } → new_ary drop_while → Enumerator القيم المعادة تعاد مصفوفة جديدة تحوي جميع عناصر المصفوفة المعطاة باستثناء العناصر الأولى التي تعيد كل منها القيمة true عند تطبيق الكتلة البرمجيَّة block عليها، أو يعاد كائنٌ من النوع Enumerator إن لم تعطَ الكتلة block. أمثلة مثالٌ على ...

يجلب التابع take_while العناصر الأولى من مصفوفة التي تحقق شرطًا معينًا؛ أي يستمر التابع في جلب العناصر الأولى ما دامت محققة للشرط ويتوقف عندما لا يحقق أحد العناصر ذلك الشرط المعطى. إن لم تمرَّر أية كتلة إلى التابع take_while، فسيعيد كائنًا من النوع Enumerator. البنية العامة take_while { |obj| block } → new_ary take_while → Enumerator القيم المعادة تعاد مصفوفة جديدة تحوي العناصر الأولى التي تعاد معها القيمة true عند تطبيق الكتلة block عليها إلى أن تعاد القيمة false أو القيمة ...

يعيد التابع collect مصفوفة جديدة تحوي نتائج تنفيذ الكتلة المعطاة دفعةً واحدةً مع كل عنصر من عناصر المُعدِّد الذي استدعي معه. إن لم تُعطَ أية كتلة، فسيعيد التابع كائنًا من النوع Enumerator. البنية العامة collect { |obj| block } → array collect → an_enumerator القيمة المعادة تعاد مصفوفة تحوي نتائج تنفيذ الكتلة المعطاة دفعةً واحدةً مع كل عنصر من عناصر المُعدِّد المعطى، أو يعاد كائن من النوع Enumerator إن لم تُعطَ أية كتلة. أمثلة مثال على استعمال التابع collect: (1..4).map { |i| ...

يعيد التابع map مصفوفة جديدة تحوي النتائج المقابلة لكل عنصر من عناصر الكائن القابل للتعداد المعادة من الكتلة المعطاة بعد تمريره إليها. إن لم تُعطَ أية كتلة، فسيعيد التابع كائنًا من النوع Enumerator. البنية العامة map { |obj| block } → array map → an_enumerator القيمة المعادة تعاد مصفوفة جديدة تحوي النتائج المقابلة لكل عنصر من عناصر الكائن القابل للتعداد المعادة من الكتلة block بعد تمريره إليها. إن لم تُعطَ أية كتلة، فسيعاد كائن من النوع Enumerator. أمثلة مثال على استعمال التابع map: ...

يٌبقِي التابع keep_if على جميع عناصر المصفوفة التي تحقق شرطًا معينًا ويحذف العناصر الأخرى المتبقية. إن لم تمرَّر كتلة برمجية، فسيعيد التابع keep_if كائنًا من النوع Enumerator. البنية العامة keep_if { |item| block } → ary keep_if → Enumerator القيم المعادة تعاد المصفوفة نفسها المعطاة بعد إزالة جميع العناصر الغير محققة للشرط الذي تحدده الكتلة block، أو يعاد كائن من النوع إن Enumerator إن لم تعطَ الكتلة block. أمثلة مثالٌ على استخدام التابع keep_if: a = %w{ a b c d ...

يعيد التابع partition مصفوفتين تحتوي الأولى على عناصر الكائن القابل للتعداد المحققة للكتلة المعطاة (التي أعادت عند تمريرها إليها قيمة صحيحة) وتحتوي الأخرى على العناصر المتبقية. إن لم تُعطَ أية كتلة، فسيعيد التابع كائنًا جديدًا من النوع Enumerator. البنية العامة partition { |obj| block } → [ true_array, false_array ] partition → an_enumerator القيمة المعادة تعاد مصفوفتين تحتوي الأولى على عناصر الكائن القابل للتعداد المحققة للكتلة المعطاة (التي أعادت عند تمريرها إليها قيمة صحيحة) وتحتوي الأخرى على العناصر المتبقية، أو يعاد كائن ...

ينشئ التابع new كائنًا جديدًا من النوع Enumerator يمكن استعماله ككائن قابل للتعداد (Enumerable). البنية العامة new(size = nil) { |yielder| ... } new(obj, method = :each, *args) في الشكل الأول للتابع، يُعرَّف التكرار عبر الكتلة المعطاة التي يمكن استخدام الكائن yielder - المعطى كمعامل - فيها لإعادة القيمة الناتجة عبر استدعاء التابع yield (أو اسمه البديل +>>+). في الشكل الثاني - المهمل - للتابع، يتكرر مُعدِّدٌ مُولَّد عبر الكائن obj المعطى باستعمال التابع method المعطى مع تمرير الوسائط args إليه. لا يُشجَّع على ...

يستدعي التابع each_index كتلة برمجية محددة مع فهرس كل عنصر من عناصر مصفوفة، إذ يُمرَّر ذلك الفهرس كوسيط إلى الكتلة ثم يعيد المصفوفة نفسها. إن لم تمرَّر أيَّة كتلة إلى التابع each_index، فسيُعيد كائنًا من النوع Enumerator. البنية العامة each_index { |index| block } → ary each_index → Enumerator القيم المعادة تعاد المصفوفة نفسها المعطاة بعد تطبيق الكتلة block على فهرس كل عنصر من عناصرها، أو يعاد كائنٌ من النوع Enumerator إن لم تعطَ الكتلة block. أمثلة مثالٌ على استخدام ...