نتائج البحث

يبحث التابع assoc في العناصر الأولى للمصفوفات الفرعية الموجودة في المصفوفة المستدعاة معه عن الكائن المُمرّر إليها ثم يعيد المصفوفة الفرعية الأولى التي يكون أول عنصر فيها هو ذلك الكائن، أو يعيد القيمة nil في حالة عدم العثور على ذلك الكائن. تُجرَى عملية الموازنة بين العنصر الأول من كل مصفوفة فرعية والكائن obj باستعمال المعامل . البنية العامة assoc(obj) → element_ary or nil المعاملات obj الكائن المراد البحث في العناصر الأولى من المصفوفات الفرعية. القيم المعادة تعاد أول مصفوفة ...

يعدُّ هذا التابع اسمًا بديلًا للتابع unshift. انظر أيضًا التابع unshift: يضيف الكائنات المُمرَّرة إليه إلى بداية المصفوفة التي استُدعيت معه مع إزاحة العناصر الأخرى إلى الأمام. التابع push: يضيف جميع الكائنات المُمرّرة إليه إلى نهاية المصفوفة التي استُدعيت معه. التابع shift: يحذف أول عنصر أو أول n عنصر من عناصر مصفوفة ثم يعيده أو يعيد مصفوفة تحوي العناصر المحذوفة. التابع drop: يحذف أول n عنصر من مصفوفة ثمَّ يضع بقية العناصر في مصفوفة جديدة ويعيدها. التابع take: يعيد أول ...

يجمع التابع join جميع عناصر المصفوفة التي استُدعيت معها سويةً في سلسلة نصية ويفصل بينها بفاصل معين. البنية العامة join(separator=$,) → str المعاملات separator المحرف الذي يراد استعماله كفاصل بين عناصر المصفوفة عند وضعها في سلسلة نصية. إن كانت قيمة هذا الفاصل هي nil، فسيستخدم التابع المحرف $ الافتراضي. أما إن كانت قيمة كلٍّ من separator و $ هي nil، فسيستخدم التابع سلسلة نصية فارغة كفاصل. القيم المعادة تعاد سلسلة نصية تحوي جميع عناصر المصفوفة المعطاة مفصولةً بالفاصل separator. ...

يختار التابع sample عنصرًا واحدًا أو عدة عناصر بشكل عشوائي من المصفوفة التي استُدعيت معه. يتم اختيار العناصر باستخدام فهارس عشوائية وفريدة لضمان عدم اختيار العنصر نفسه مجدَّدًا ما لم تحتوِ المصفوفة على عناصر متكررة. البنية العامة sample → obj sample(random: rng) → obj sample(n) → new_ary sample(n, random: rng) → new_ary المعاملات random يُستخدم هذا الوسيط الاختياري (إن أعطي) كمولد عشوائي للأعداد التي تمثل فهارس العناصر العشوائية المراد جلبها. قيمته الافتراضية هي: rng. n عدد صحيح يحدد عدد العناصر العشوائية المراد ...

يحذف التابع reject!‎ جميع عناصر المصفوفة التي لم تحقق شرطًا محددًا. قد لا تتغيير المصفوفة مباشرةً في كل مرة تستدعى فيها الكتلة block الممرَّرة إلى التابع. إن لم تُمرَّر أية كتلة إلى التابع !reject، فسيعيد كائنًا من النوع Enumerator. البنية العامة reject! { |item| block } → ary or nil reject! → Enumerator القيم المعادة تعاد المصفوفة نفسها المعطاة بعد حذف عناصرها التي لم تعاد معها القيمة true عند تطبيق الكتلة bloc عليها، أو تعاد القيمة nil إن لم يحذف أي ...

يحاول التابع try_convert()‎ أن يحوّل كائنًا إلى مصفوفة بالاستعانة بالتابع to_ary. يمكن كذلك استخدام هذا التابع للتحقق مما إذا كان الوسيط المُمرّر إليه مصفوفةً أم لا. البنية العامة try_convert(obj) → array or nil المعاملات obj الكائن المراد تحويله إلى مصفوفة. القيم المعادة تعاد مصفوفة جديدة تضم محتوى الكائن obj، أو القيمة nil في حالة تعذر تحويل الكائن obj لسبب ما. أمثلة بعض الأمثلة لاستخدام التابع try_convert()‎: Array.try_convert([1]) #=> [1] Array.try_convert("1") #=> nil if tmp = Array.try_convert(arg) ...

يجلب التابع slice عنصرًا ذي فهرس محدد، أو جزءًا محددًا ببداية وطول، أو مجالًا محددًا ببداية ونهاية من مصفوفة. إن مُرِّرت قيم سالبة للفهارس، فسيُحسَب موضع العنصر بدءًا من نهاية المصفوفة، إذ تمثل القيمة ‎-1 فهرس العنصر الأخير. ستُعاد مصفوفة فارغة في حال كان فهرس بداية المجال المحدد يقع عند نهاية المصفوفة. البنية العامة slice(index) → obj or nil slice(start, length) → new_ary or nil slice(range) → new_ary or nil المعاملات index عدد صحيح يمثل فهرس العنصر المراد اقتطاعه من المصفوفة المعطاة. ...

يعيد التابع permutation كل التبديلات (permutations) الممكنة لجميع عناصر مصفوفة، أو كل التبديلات المكونة من n عنصر من عناصر المصفوفة فقط ثم يعيد المصفوفة نفسها. لا يوجد أي ضمان للتنبؤ بترتيب العناصر المعادة. إن لم تُمرَّر أي كتلة (block) إلى هذا التابع، فسيعيد كائنًا من النوع Enumerator. البنية العامة permutation { |p| block } → ary permutation → Enumerator permutation(n) { |p| block } → ary permutation(n) → Enumerator المعاملات n عدد صحيح يحدد عدد عناصر المصفوفات الفرعية المراد تبديل عناصر المصفوفة ...

يجلب التابع last آخر عنصر أو آخر n عنصر من مصفوفة. البنية العامة last → obj or nil last(n) → new_ary المعاملات n عدد صحيح يمثل عدد العناصر الأخيرة التي يراد جلبها من المصفوفة المعطاة. القيم المعادة يعاد العنصر الأخير من المصفوفة المعطاة إن لم يمرَّر أي وسيط، أو تعاد مصفوفة جديدة تحوي آخر n عنصر من المصفوفة المعطاة. إن كانت المصفوفة فارغة، فستعاد القيمة nil إن لم يمرَّر أي وسيط، أو تعاد مصفوفة فارغة إن أعطي الوسيط n. أمثلة ...

يُدوّر التابع rotate!‎ عناصر المصفوفة التي استُدعيت معه ليكون العنصر ذو الفهرس الممرَّر إليها هو العنصر الأول. إن كان العدد الممرَّر إليها سالبًا، فسيُدوّر التابع rotate!‎ المصفوفة في الاتجاه المعاكس، إذ يُحسَب موضع العنصر بدءًا من نهاية المصفوفة فسيكون فهرس العنصر الأخير هو ‎-1‎. البنية العامة rotate!(count=1) → ary المعاملات count عددٌ صحيحٌ يمثل فهرس العنصر الذي يراد أن يصبح أول عنصرٍ في المصفوفة المعطاة. القيم المعادة تعاد المصفوفة نفسها المعطاة بعد إزاحة (تدوير) عناصرها ليكون العنصر ذو الفهرس count ...

يبدِّل التابع replace محتوى المصفوفة الممرَّرة إليه مكان محتوى المصفوفة المستدعاة معه مع تغيير طولها إن دعت الحاجة لذلك. البنية العامة replace(other_ary) → ary المعاملات other_ary المصفوفة التي ستحل محتوياتها مكان كامل محتويات المصفوفة المعطاة. القيم المعادة تعاد المصفوفة نفسها المعطاة بعد استبدال محتوى المصفوفة other_ary بمحتواها. أمثلة أمثلة على استخدام التابع replace: a = [ "a", "b", "c", "d", "e" ] a.replace([ "x", "y", "z" ]) #=> ["x", "y", "z"] a ...

يرتب التابع sort!‎ عناصر المصفوفة التي استُدعيت معه. ستجرى عملية الموازنة بين عناصر المصفوفة المراد ترتيبها باستعمال المعامل <=> أو باستعمال كتلة برمجية محددة. إن استعملت الكتلة البرمجية block في ترتيب العناصر، فيجب أن تجري موازنة بين العنصر a والعنصر b وتعيد عددًا سالبًا إن كان b أكبر من a، أو العدد 0 إن كانا متساويين، أو عددًا موجبًا إن كان b أصغر من a. مع ذلك، لن تكون النتيجة مضمونة مئة بالمئة، إذ لا يمكن التنبؤ بترتيب العناصر المتساوية ...

يقتطع التابع slice!‎ عنصرًا ذي فهرس محدد، أو جزءًا محددًا ببداية وطول، أو مجالًا محددًا ببداية ونهاية من المصفوفة التي استدعيت معه. يعيد التابع slice!‎ العناصر المحذوفة، أو nil إن كان index خارج النطاق. البنية العامة slice!(index) → obj or nil slice!(start, length) → new_ary or nil slice!(range) → new_ary or nil المعاملات index عدد صحيح يمثل فهرس العنصر المراد اقتطاعه من المصفوفة المعطاة. start عدد صحيح يمثل فهرس البداية للعناصر المراد اقتطاعها من المصفوفة المعطاة. length عدد صحيح يمثل طول العناصر ...

يجلب التابع at عنصرًا ذي فهرس محدد من المصفوفة المستدعاة معه. البنية العامة at(index) → obj or nil المعاملات index فهرس العنصر المراد جلبه من المصفوفة المعطاة. القيم المعادة يعاد العنصر ذو الفهرس index من المصفوفة المعطاة، أو القيمة nil إن كان الفهرس index يقع خارج مجال عناصر المصفوفة. إن كانت قيمة الفهرس index سالبة، فسيُحسَب موقع العنصر بدءًا من نهاية المصفوفة. أمثلة بعض الأمثلة على استخدام التابع at: a = [ "a", "b", "c", "d", "e" ] a.at(0) ...

يحدد التابع select جميع عناصر المصفوفة المحققة لشرط معين ويضعها في مصفوفة جديدة. إن لم تمرَّر أية كتلة إلى التابع select، فسيعيد كائنًا من النوع Enumerator. البنية العامة select { |item| block } → new_ary select → Enumerator القيم المعادة تعاد مصفوفة جديدة تحوي جميع عناصر المصفوفة المعطاة التي أعيدت معها القيمة true عند تطبيق الكتلة block عليها، أو يعاد كائن من النوع Enumerator إن لم تعطَ الكتلة block. أمثلة أمثلة على استخدام التابع select: [1,2,3,4,5].select { |num| num.even? ...

يجلب التابع fetch عنصرًا ذا فهرس محدَّد من مصفوفة. إن كان الفهرس المعطى لعنصرٍ يقع خارج نطاق المصفوفة، فسيُطلَق الخطأ IndexError. يمكن تجنب إطلاق هذا الخطأ بتمرير وسيطٍ ثانٍ أو كتلة برمجية إلى التابع fetch ليُظهَر أو تُنفَّذ في مثل هذه الحالة. البنية العامة fetch(index) → obj fetch(index, default) → obj fetch(index) { |index| block } → obj المعاملات index عدد صحيح يمثل فهرس العنصر المراد جلبه من المصفوفة المعطاة. default قيمة افتراضية تُطبَع -بدلًا من إطلاق الخطأ IndexError- عندما يشير ...

يعيد التابع to_a المصفوفة التي استُدعيت معه. في حال استدعاء هذا التابع مع كائن من صنف فرعي (subclass) من الصنف Array، فسيُحوَل ذلك الكائن إلى كائن من الصنف Array. البنية العامة to_a → ary القيم المعادة تعاد المصفوفة نفسها المعطاة. أمثلة مثالٌ على استخدام التابع to_a: [ "a", nil, "b", nil, "c", nil ].to_a #=> [ "a", nil, "b", nil, "c", nil ] انظر أيضًا التابع to_ary: يعيد المصفوفة التي استُدعيت معه. التابع to_h: يعيد نتيجة تحويل المصفوفة ...

يجلب التابع take أول n عنصر من مصفوفة. إن مرِّر عدد سالب إلى هذا التابع، فسيُطلَق الخطأ ArgumentError. البنية العامة take(n) → new_ary المعاملات n عدد صحيح يمثل عدد العناصر الأولى المراد جلبها من المصفوفة المعطاة. القيم المعادة تعاد مصفوفة جديدة تحوي العناصر n الأولى الموجودة في المصفوفة المعطاة. أمثلة مثالٌ على استخدام التابع take: a = [1, 2, 3, 4, 5, 0] a.take(3) #=> [1, 2, 3] انظر ...

يجمع التابع sum عناصر المصفوفة التي استُدعيت معه مع بعضها بعضًا. إن مُرِّرت كتلة برمجية إلى هذا التابع، فستُطبَّق تلك الكتلة على كل عنصر من عناصر المصفوفة ثم ستُجمَع النواتج المعادة لجميع العناصر. في حال كانت المصفوفة فارغة، ستُعاد القيمة المُمرّرة إلى هذا التابع. يمكن استخدام هذا التابع مع المصفوفات التي تحوي قيمًا غير عددية بتحديد قيمة مناسبة للوسيط init. يجدر التنبيه إلى أنّ التابعين join و flatten هما أسرع من التابع sum بالنسبة للمصفوفات التي تضم سلاسل نصية أو ...

يجلب التابع values_at عنصرًا واحدًا أو أكثر ذا فهرس محدد من مصفوفة. البنية العامة values_at(selector, ...) → new_ary المعاملات selector عدد صحيح يمثل فهرس العنصر المراد جلبه من المصفوفة المعطاة. … أعداد صحيحة تمثل فهارس العناصر المراد جلبها من المصفوفة المعطاة. القيم المعادة تعاد مصفوفة جديدة تحوي عنصرًا واحدًا أو أكثر ذي الفهرس selector من المصفوفة المعطاة. إن كان الوسيط selector مجالًا، فستُجلَب العناصر التي تقع فهارسها ضمن ذلك المجال وتوضع في المصفوفة المعادة. إن وقع فهرس عنصر خارج مجال ...

يستخرج التابع dig العنصر المتشعِّب (nested value) المحدَّد بسلسلة المعاملات الممرَّرة إليه من مصفوفة متعددة الأبعاد وذلك عبر استدعاء dig عند كل مستوى تشعب. البنية العامة dig(idx, ...) → object المعاملات idx عدد صحيح يمثل فهرسًا يشير إلى عنصر محدد (مصفوفة فرعية) من المصفوفة الخارجية. … أعداد صحيحة يشير أول عدد منها إلى عنصر محدد (قد يكون مصفوفة فرعية) من المصفوفة الفرعية التي حدِّدت عبر المعامل idx، وثاني عدد منها إلى عنصر محدد من المصفوفة الفرعية التي حدِّدت عبر ...

يحذف التابع compact!‎ كل العناصر ذات القيمة nil من المصفوفة التي استدعيت معه ثم يعيدها. إن لم تحوي المصفوفة أي عنصر يساوي nil، فسيعيد التابع compact!‎ القيمة nil. البنية العامة compact! → ary or nil القيم المعادة تعاد المصفوفة نفسها المعطاة بعد حذف جميع العناصر ذات القيمة nil منها، أو تعاد القيمة nil إن لم تحوِ تلك المصفوفة على أي عنصر تساوي قيمة القيمة nil. أمثلة أمثلة على استخدام التابع compact!‎: [ "a", nil, "b", nil, "c" ].compact! ...

يبحث التابع rassoc عن عنصر محدد في العناصر الثانية للمصفوفات الفرعية الموجودة في المصفوفة المستدعاة معه ثم يعيد المصفوفة الفرعية التي يُعثَر فيها على ذلك العنصر‎. تُجرَى عملية الموازنة بين العنصر الثاني من كل مصفوفة فرعية والقيمة الممررة إلى التابع باستعمال المعامل ==. البنية العامة rassoc(obj) → element_ary or nil المعاملات obj الكائن المراد البحث عنه. القيم المعادة تعاد المصفوفة الفرعية الموجودة في المصفوفة المعطاة والتي تطابقت القيمة obj مع العنصر الثاني فيها، أو تعاد القيمة nil إن لم يتطابق ...

يعيد التابع to_ary المصفوفة التي استُدعيت معه. البنية العامة to_ary → ary القيم المعادة تعاد المصفوفة نفسها المعطاة. أمثلة مثالٌ على استخدام التابع to_ary: [ "a", nil, "b", nil, "c", nil ].to_ary #=> [ "a", nil, "b", nil, "c", nil ] انظر أيضًا التابع to_a: يعيد المصفوفة التي استُدعيت معه. التابع to_h: يعيد نتيجة تحويل المصفوفة التي استُدعيت معه إلى مصفوفة مكونة من الأزواج [key, value]. التابع inspect: يحول مصفوفة إلى سلسلة نصية. التابع try_convert‎: يحاول أن ...

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

يحذف التابع delete_at عنصرًا ذا فهرس محدَّد من مصفوفة. البنية العامة delete_at(index) → obj or nil المعاملات index عدد صحيح يمثل فهرس العنصر المراد حذفه. القيم المعادة يعاد العنصر المحذوف ذو الفهرس index من المصفوفة المعطاة، أو تعاد القيمة nil إن كان الفهرس index المعطى يقع خارج مجال المصفوفة. أمثلة أمثلة على استخدام التابع delete_at: a = ["ant", "bat", "cat", "dog"] a.delete_at(2) #=> "cat" a ...

يشبه التابع repeated_combination التابع combination باستثناء أنه يمكنه تجميع العناصر مع نفسها (أي تكرار العناصر نفسها). لا يوجد أي ضمان للتنبؤ بترتيب العناصر المجمَّعة المعادة. إن لم تمرَّر أي كتلة (block) إلى هذا التابع، فسيعيد كائنًا من النوع Enumerator. البنية العامة repeated_combination(n) { |c| block } → ary repeated_combination(n) → Enumerator المعاملات n عدد صحيح يحدد عدد عناصر المصفوفات الفرعية المراد تجميع عناصر المصفوفة المعطاة ضمنها. القيم المعادة تعاد المصفوفة نفسها المعطاة بعد تجميع عناصرها مع نفسها ومع العناصر الأخرى بترتيب ...

يعيد التابع compact نسخةً جديدة من المصفوفة التي استُدعي معها مع حذف كل العناصر التي تساوي nil منها. البنية العامة compact → new_ary القيم المعادة تعاد مصفوفة جديدة تحوي جميع عناصر المصفوفة المعطاة باستثناء العناصر ذات القيمة nil. أمثلة مثالٌ على استخدام التابع compact: [ "a", nil, "b", nil, "c", nil ].compact #=> [ "a", "b", "c" ] انظر أيضًا التابع compact! ...

يعيد التابع shuffle ترتيب عناصر مصفوفة بشكل عشوائي ثم يضعها في مصفوفة جديدة. البنية العامة huffle → new_ary shuffle(random: rng) → new_ary المعاملات random يُستخدم هذا الوسيط الاختياري (إن أعطي) كمولد عشوائي لترتيب العناصر بحسب فهرسها. قيمته الافتراضية هي: rng. القيم المعادة تعاد مصفوفة جديدة تحوي عناصر المصفوفة المعطاة مرتَّبةً بشكل عشوائي. أمثلة أمثلة على استخدام التابع shuffle: a = [ 1, 2, 3 ] #=> [1, 2, 3] a.shuffle ...

يشبه التابع flatten!‎ التابع flatten في جميع النواحي باستثناء أنه لا يضع الناتج في مصفوفة جديدة وإنما يعدِّل على المصفوفة الأصلية نفسها. يقبل هذا التابع تمرير المعامل level الاختياري الذي يحدد مستوى التعاودية (recursion level). البنية العامة flatten! → ary or nil flatten!(level) → ary or nil المعاملات level عدد صحيح يحدد مستوى التشعُّب التي يراد استخلاص العناصر الواقعة فيه وجعلها أحادية. القيم المعادة تعاد المصفوفة نفسه المعطاة بعد تحويلها إلى مصفوفة أحادية البعد أي بعد استخراج العناصر المتشعبة منها ...

يحذف التابع delete جميع عناصر المصفوفة المساوية لقيمة محددة ثم يعيد آخر عنصر حذفه، أو القيمة nil أو ناتج تطبيق كتلة برمجية محددة إن لم يعثر على أي عنصر لحذفه. البنية العامة delete(obj) → item or nil delete(obj) { block } → item or result of block المعاملات obj الكائن المراد حذفه -أينما وجد- في المصفوفة المعطاة. القيم المعادة تعاد المصفوفة نفسها المعطاة بعد حذف العناصر المساوي للوسيط obj منها، أو تعاد القيمة nil إن لم يعثر على عنصر مساوٍ ...

يزيل التابع clear كل عناصر المصفوفة. البنية العامة clear → ary القيم المعادة تعاد المصفوفة نفسها المعطاة بعد حذف جميع عناصرها. أمثلة مثال على استخدام التابع clear: a = [ "a", "b", "c", "d", "e" ] a.clear #=> [ ] انظر أيضًا التابع delete_at: يحذف عنصرًا ذا فهرس محدَّد من مصفوفة. التابع drop: يحذف أول n عنصر من مصفوفة ثمَّ يضع بقية العناصر في مصفوفة جديدة ويعيدها. التابع compact: يعيد نسخةً جديدة من المصفوفة التي استُدعي ...

يُرتِّب التابع sort_by!‎ المصفوفة التي استُدعيت معه وفقًا لمجموعة من المفاتيح (set of keys) المولدة عبر تمرير كل عنصر من عناصر المصفوفة إلى كتلة برمجية مُحددة. لن تكون النتيجة مضمونة مئة بالمئة، إذ لا يمكن التنبؤ بترتيب عنصري متجاورين لها نفس المفتاح. في حال عدم تمرير كتلة برمجية إلى التابع sort_by!‎، سيعيد كائنًا من النوع Enumerator. البنية العامة sort_by! { |obj| block } → ary sort_by! → Enumerator القيم المعادة تعاد المصفوفة نفسها المعطاة بعد ترتيب عناصرها وفقًا للقيمة التي تعيدها ...

يختار التابع !select جميع عناصر المصفوفة المحققة لشرط معين ويحذف العناصر الأخرى المتبقية التي لم تحقق هذا الشرط. قد لا تتغير المصفوفة مباشرةً في كل مرة تُستدعى فيها الكتلة البرمجية الممررة إلى هذا التابع، وستعاد القيمة nil إن لم يجرى أي تعديل على المصفوفة. إن لم تمرَّر أية كتلة إلى التابع !select، فسيعيد كائنًا من النوع Enumerator. البنية العامة select! {|item| block } → ary or nil select! → Enumerator القيم المعادة تعاد المصفوفة نفسها المعطاة بعد الإبقاء على العناصر التي ...

يحذف التابع delete_if جميع عناصر المصفوفة التي تعيد الكتلة البرمجية المعطاة عند تطبيقها على كل عنصر منها القيمة true. يُعدَّل على المصفوفة مباشرةً في كل مرَّة تستدعى فيها الكتلة، وليس بعد انتهاء التكرار (iteration). إن لم تمرَّر أي كتلة إلى هذا التابع، فسيعيد كائنًا من النوع Enumerator. البنية العامة delete_if { |item| block } → ary delete_if → Enumerator القيم المعادة تعاد المصفوفة نفسها بعد حذف العناصر التي أعيدت معها القيمة true عند تطبيق الكتلة block على كلٍّ منها، أو ...

يحذف التابع uniq العناصر المتكررة من مصفوفة ثم يضع العناصر المتبقية في مصفوفة جديدة. إن مرِّرت كتلة برمجية، فستُستخدَم القيمة التي تعيدها هذه الكتلة لكل عنصر في عملية الموازنة. يوازن التابع uniq القيم باستخدام التابع hash والتابع eql?‎ لأجل تحسين الأداء. كما يقتطع التابع العناصر المتكررة من مصفوفة بالترتيب، إذ يحتفظ بالظهور الأول للقيمة المتكررة ويحذف القيمة الأخرى المتماثلة. البنية العامة uniq → new_ary uniq { |item| ... } → new_ary القيم المعادة تعاد مصفوفة جديدة تحوي جميع عناصر المصفوفة المعطاة ...

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

يتحقق التابع include?‎ إن كان العنصر المُمرّر إليه موجودًا في المصفوفة التي استُدعيت معه (أي إذا كان هنالك عنصر من المصفوفة يساوي الوسيط الممرر بحسب المعامل ==) البنية العامة include?(object) → true or false المعاملات object الكائن الذي يراد التحقق من وجوده في المصفوفة المعطاة. القيم المعادة تعاد القيمة true إن كان العنصر object موجودًا في المصفوفة المعطاة. أمثلة مثالٌ على استخدام التابع include?‎: a = [ "a", "b", "c" ] a.include?("b") #=> true a.include?("z") #=> ...

يعيد التابع max أكبر عنصر موجود في المصفوفة التي استُدعيت معه. يفترض الشكل الأول للتابع (تجده في القسم «البنية العامة») أنَّ كل الكائنات تقدم (implement) الصنف Comparable. أمَّا الشكل الثاني، فيستخدم كتلة برمجية محددة للموازنة بين العناصر (يُجرَى ذلك باستعمال a <=> b). إن مرِّر الوسيط n، فسيعيد التابع مصفوفة تحوي أكبر n عنصر موجود في المصفوفة الأصلية. البنية العامة max → obj max { |a, b| block } → obj max(n) → array max(n) { |a, b| block } → array المعاملات ...

يحذف التابع uniq!‎ العناصر المتكررة من مصفوفة. إن مرِّرت كتلة برمجية، فستُستخدَم القيمة التي تعيدها هذه الكتلة لكل عنصر في عملية الموازنة. يوازن التابع uniq!‎ القيم باستخدام التابع hash والتابع eql?‎ لأجل تحسين الأداء. كما يقتطع التابع العناصر المتكررة من مصفوفة بالترتيب، إذ يحتفظ بالظهور الأول للقيمة المتكررة ويحذف القيمة الأخرى المتماثلة. البنية العامة uniq! → ary or nil uniq! { |item| ... } → ary or nil القيم المعادة تعاد المصفوفة نفسها المعطاة بعد إزالة العناصر المتكررة منها، أو تعاد ...

يعيد التابع min أصغر عنصر موجود في المصفوفة التي استُدعيت معه. يفترض الشكل الأول للتابع (تجده في القسم «البنية العامة») أنَّ كل الكائنات تقدم (implement) الصنف Comparable. أما الشكل الثاني، فيستخدم كتلة برمجية محددة للموازنة بين العناصر (يُجرَى ذلك باستعمال a <=> b). إن مُرِّر الوسيط n، فسيعيد التابع مصفوفةً تحوي أصغر n عنصر موجود في المصفوفة الأصلية. البنية العامة min → obj min {| a,b | block } → obj min(n) → array min(n) {| a,b | block } → array المعاملات ...

يضيف التابع push جميع الكائنات المُمرّرة إليه إلى نهاية المصفوفة التي استُدعيت معه. يعيد هذا التابع المصفوفة نفسها، لذلك يمكن تطبيقه بشكل متسلسل. البنية العامة push(obj, ... ) → ary المعاملات obj الكائن المراد إضافته إلى نهاية المصفوفة المعطاة … الكائنات الأخرى المراد إضافتها إلى نهاية المصفوفة المعطاة. القيم المعادة تعاد المصفوفة نفسها المعطاة بعد إضافة الكائن obj والكائنات الأخرى الممررة إليها. أمثلة أمثلة على استخدام التابع push: a = [ "a", "b", "c" ] a.push("d", "e", "f") ...

يعيد التابع to_h نتيجة تحويل المصفوفة التي استُدعيت معه إلى مصفوفة مكونة من الأزواج [key, value]. البنية العامة to_h → hash القيم المعادة يعاد ناتج تحويل المصفوفة المعطاة إلى خريطة (map) مكونة من الأزواج key/value. أمثلة مثالٌ على استخدام التابع to_h: [[:foo, :bar], [1, 2]].to_h # => {:foo => :bar, 1 => 2} انظر أيضًا التابع to_a: يعيد المصفوفة التي استُدعيت معه. التابع inspect: يحول مصفوفة إلى سلسلة نصية. التابع try_convert‎: يحاول أن يحوّل كائنًا obj ...

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

يستدعي التابع cycle كتلة برمجية محددة مع كل عنصر من عناصر المصفوفة عددًا محددًا من المرات أو عددًا لا نهائيًّا من المرات إن أعطيت القيمة nil. أمَّا إن مُرِّرت إليه قيمة سالبة أو كانت المصفوفة فارغة، فلن يفعل هذا التابع أي شيء. يعيد التابع القيمة nil إن انتهت سلسلة الاستدعاءات المطبقة على كل عنصر دون مقاطعة.إن لم تمرَّر أي كتلة، فسيعيد التابع cycle كائنا من النوع Enumerator. البنية العامة cycle(n=nil) { |obj| block } → nil cycle(n=nil) → Enumerator المعاملات ...

يتحقق التابع empty?‎ إن كانت مصفوفةٌ فارغةً أم لا. البنية العامة empty? → true or false القيم المعادة تعاد القيمة true المنطقية إن كانت المصفوفة المعطاة فارغة، أو القيمة false خلا ذلك. أمثلة بعض الأمثلة على استخدام التابع empty?‎: [].empty? #=> true [1, 5].empty? #=> false انظر أيضًا التابع include?‎: يتحقق إن كان العنصر المُمرّر إليه موجودًا في المصفوفة التي استُدعيت معه. التابع frozen?‎: يتحقق إن كانت مصفوفةٌ مُجمَّدةً ( frozen) بشكل دائم أو مؤقت ...

يستدعي التابع !collect كتلة برمجية محددة مع كل عنصر من عناصر مصفوفة ثم يضع القيمة التي أعادتها تلك الكتلة مكان العنصر الذي استدعيت معه. إن لم يمرَّر أي شيء إلى هذا التابع، فسيعيد كائنا من النوع Enumerator. البنية العامة collect! {|item| block } → ary collect! → Enumerator القيم المعادة تعاد المصفوفة نفسها المعطاة بعد تبديل القيمة الجديدة التي تعيدها الكتلة block عند تطبيقها على كل عنصر من عناصر تلك المصفوفة مكان القيمة القديمة لذلك العنصر، أو يعاد كائنٌ من ...

يُدرج التابع insert القيم المُمرّرة إليه قبل عنصرٍ ذي فهرس محدد. البنية العامة insert(index, obj...) → ary المعاملات index عدد صحيح يمثل فهرس العنصر المراد إدراج محتوى المعامل ...obj قبله. إن أعطيت قيمة سالبة للفهرس index، فسيُحسَب موقع العنصر بدءًا من نهاية المصفوفة وستضاف تلك القيم المعطاة بعد العنصر، إذ يمثِّل الفهرس ‎-‎1 مثلًا آخر عنصر في المصفوفة وستضاف القيم الممررة في نهاية المصفوفة. ...obj الكائنات المراد إدراجها قبل العنصر ذي الفهرس index في المصفوفة المعطاة. القيم المعادة تعاد ...

يجعل التابع flatten المصفوفة التي تحوي عناصر متشعبة ضمنها مصفوفةً أحادية البعد بشكل تعاودي (recursively)؛ أي أنَّ كل عنصر من عناصر المصفوفة المعطاة والذي قد يكون نفسه مصفوفةً متشعبةً من مستوًى واحدٍ أو أكثر ستُستخلَص عناصره وتضاف إلى مصفوفة جديدة. يقبل هذا التابع تمرير المعامل level الاختياري الذي يحدد مستوى التعاودية (recursion level). البنية العامة flatten → new_ary flatten(level) → new_ary المعاملات level عدد صحيح يحدد مستوى التشعُّب التي يراد استخلاص العناصر الواقعة فيه وجعلها أحادية. القيم المعادة تعاد مصفوفة ...

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