التابع Enumerable.chunk_while في روبي
ينشئ التابع chunk_while مُعدِّدًا لكل جزء من العناصر المجمَّعة سويةً. تُعرَّف بداية الأجزاء (chunks) عبر الكتلة المعطاة.
البنية العامة
chunk_while {|elt_before, elt_after| bool } → an_enumerator
يفصل هذا التابع كل جزء باستعمال العناصر المتجاورة، التي هي elt_before و elt_after، في المُعدِّد المستقبل. يفصل هذا التابع الأجزاء بين elt_before و elt_after حيث تعيد الكتلة القيمة false.
تُستدعَى الكتلة مع طول المُعدِّد المستقبل مطروحًا منه الواحد.
ينتج عن المُعدِّد الناتج العناصر المجمَّعة كمصفوفة. لذلك، يمكن استدعاء التابع each بالشكل التالي:
enum.chunk_while { |elt_before, elt_after| bool }.each { |ary| ... }
يمكن استعمال توابع أخرى من الوحدة Enumerator و Enumerable أيضًا مثل to_a، و map ...إلخ.
القيمة المعادة
يعاد المُعدِّد الناتج الذي ينتج عنه (yield) العناصر المجمَّعة كمصفوفة.
أمثلة
استعمال التابع chunk_while لتجميع سلسلة الأعداد الفرعية المتزايدة مباشرةً بمقدار 1سويةً:
a = [1,2,4,9,10,11,12,15,16,19,20,21]
b = a.chunk_while {|i, j| i+1 == j }
p b.to_a #=> [[1, 2], [4], [9, 10, 11, 12], [15, 16], [19, 20, 21]]
c = b.map {|a| a.length < 3 ? a : "#{a.first}-#{a.last}" }
p c #=> [[1, 2], [4], "9-12", [15, 16], "19-21"]
d = c.join(",")
p d #=> "1,2,4,9-12,15,16,19-21"
السلسلة الفرعية المتزايدة (وليس المتناقصة) يمكن أن تُجمَّع بالشكل التالي:
a = [0, 9, 2, 2, 3, 2, 7, 5, 9, 5]
p a.chunk_while {|i, j| i <= j }.to_a
#=> [[0, 9], [2, 2, 3], [2, 7], [5, 9], [5]]
يمكن أيضًا تجميع الأعداد الزوجية والفردية المتجاورة على النحو التالي (يمكن استعمال التابع chunk لأداء الوظيفة نفسها):
a = [7, 5, 9, 2, 0, 7, 9, 4, 2, 0]
p a.chunk_while {|i, j| i.even? == j.even? }.to_a
#=> [[7, 5, 9], [2, 0], [7, 9], [4, 2, 0]]
يستطيع التابع slice_when القيام بالأمر نفسه باستثناء التقطيع (الفصل) عندما تعيد الكتلة القيمة true عوضًا عن القيمة false.
انظر أيضًا
- التابع
chunk: يُمرِّر كل عنصر من عناصر المجموعة التي استدعيت معه إلى الكتلة المعطاة ثمَّ يُقطِّعها إلى أجزاء (قطع صغيرة) بحسب القيمة المعادة من الكتلة. - التابع
drop_while: يحذف العناصر الأولى المحقِّقة لشرط معيِّن من المُعدِّد المعطى ثم يعيد مصفوفة تحوي العناصر المتبقية. - التابع
slice_when: يقطِّع عناصر الكائن القابل للتعداد إلى أجزاء تحدَّد بدايتها عبر كتلةٍ معطاةٍ ثم يعيد مُعدِّد لكل جزء من الأجزاء الناتجة.