نتائج البحث

يعيد المعامل - مصفوفة جديدة تمثل نسخة من جميع عناصر المصفوفة الأصلية باستثناء العناصر المشتركة مع المصفوفة الأخرى. تحافظ المصفوفة المعادة على نفس ترتيب العناصر في المصفوفة الأصلية. يوازن المعامل - العناصر باستخدام التابعين ()hash و ()eql?‎ للحصول على أعلى كفاءة. البنية العامة ary - other_ary → new_ary القيم المعادة تعاد مصفوفة جديدة تمثل نسخة من جميع عناصر المصفوفة الأصلية باستثناء العناصر المشتركة مع المصفوفة other_ary الأخرى. أمثلة مثالٌ عن استعمال المعامل -: [ 1, 1, 2, 2, 3, 3, ...

يجمع المعامل + مصفوفتين معًا في مصفوفة واحدة جديدة. البنية العامة ary + other_ary → new_ary القيم المعادة تعاد مصفوفة جديدة تضم المصفوفة ary والمصفوفة other_ary معًا. أمثلة مثالٌ عن استخدام المعامل +: [ 1, 2, 3 ] + [ 4, 5 ] #=> [ 1, 2, 3, 4, 5 ] a = [ "a", "b", "c" ] c = a + [ "d", "e", "f" ] c ...

يعيد معامل الموازنة <=> عددً‎ا صحيحًا (‎-1 أو 0 أو ‎+1) إذا كانت المصفوفة الأصلية أصغر من أو تساوي أو أكبر من المصفوفة الأخرى المعطاة على التوالي. يوازن كل كائن من كل مصفوفة باستخدام المعامل <=>. يوازن بين المصفوفات عنصرًا عنصرًا؛ بعبارة أخرى، يوازن العنصر الأول من المصفوفة الأولى مع العنصر الأول من المصفوفة الثانية باستخدام المعامل <=>، ثم يوازن العنصر الثاني فالثالث وهكذا دواليك. متى ما أعطيت نتيجة مغايرة للصفر لأيٍّ من تلك الموازنات التي تجرى على العناصر تباعًا ...

يعيد المعامل & مصفوفةً جديدةً تحتوي على العناصر المشتركة بين مصفوفتين دون تكرارها. تحافظ المصفوفة المعادة على نفس ترتيب العناصر في المصفوفة الأصلية. توازن العناصر باستخدام التابعين ()hash و ()eql?‎ للحصول على أعلى كفاءة. البنية العامة ary & other_ary → new_ary القيم المعادة تعاد مصفوفة جديدة تحتوي على العناصر المشتركة بين المصفوفة ary والمصفوفة other_ary دون تكرارها. أمثلة مثالٌ عن استخدام المعامل &: [ 1, 1, 3, 5 ] & [ 3, 2, 1 ] ...

إن استعمل المعامل * مع مصفوفة وسلسلة نصية، فسيُكافئ حينئذٍ العبارة ary.join(str)‎. أمَّا إن استعمل مع مصفوفة وعدد، فسيُعيد مصفوفة جديدة تتكرر فيها المصفوفة تلك عددًا من المرات مساويًا لذلك العدد المعطى. البنية العامة ary * int → new_ary ary * str → new_string القيم المعادة تعاد مصفوفة أو سلسلة نصية جديدة. أمثلة مثالٌ عن استخدام المعامل * مرةً مع عدد وأخرى مع سلسلة نصية: [ 1, 2, 3 ] * 3 #=> [ 1, 2, ...

يضيف المعامل >> كائنًا مُحدَّدًا إلى نهاية المصفوفة الأصلية ثم يعيد المصفوفة نفسها، لذا يمكن تكرار هذا المعامل عدة مرات وبشكل متسلسل. البنية العامة ary << obj → ary القيم المعادة تعاد المصفوفة نفسها المعطاة بعد إضافة الكائن obj إليها. أمثلة أمثلة عن استخدام المعامل >>: a = [ 1, 2 ] a << "c" << "d" << [ 3, 4 ] #=> [ 1, 2, "c", "d", [ 3, 4 ] ...

يتحقق المعامل == من تساوي مصفوفتين مع بعضهما بعضًا. تكون مصفوفتان متساويتين إن حوت كلاهما نفس عدد العناصر، وكان كل عنصر من المصفوفة الأولى مساويًا لنظيره في المصفوفة الثانية. البنية العامة ary == other_ary → bool القيم المعادة تُعاد القيمة true المنطقية إن كانت المصفوفتان متساويتين، أو القيمة false خلاف ذلك. أمثلة أمثلة عن استخدام المعامل ==: [ "a", "c" ] == [ "a", "c", 7 ] #=> false [ "a", "c", ...

يعيّن المعامل [] قيمة عنصر ذي فهرس محدد، أو قيم عدة عناصر تبدأ عند عنصر محدد وتمتد عددًا محددًا من العناصر، أو قيم عدة عناصر موجودة عند مجال محدد في مصفوفة. إن كانت الفهارس تشير إلى عناصر تقع خارج نطاق المصفوفة المعطاة، فستُوسَّع المصفوفة تلقائيًا. تُدرج العناصر في المصفوفة عند الفهرس start إن كانت قيمة الوسيط length تساوي 0. إن مُرِّرت قيم سالبة للفهارس، فسيُحسَب موضع العنصر بدءًا من نهاية المصفوفة، إذ تمثِّل القيمة ‎-1 فهرس العنصر الأخير. بالنسبة للوسيطين ...

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

يعيّن المعامل [] قيمة عنصر ذي فهرس محدد، أو قيم عدة عناصر تبدأ عند عنصر محدد وتمتد عددًا محددًا من العناصر، أو قيم عدة عناصر موجودة عند مجال محدد في مصفوفة. إن كانت الفهارس تشير إلى عناصر تقع خارج نطاق المصفوفة المعطاة، فستُوسَّع المصفوفة تلقائيًا. تُدرج العناصر في المصفوفة عند الفهرس start إن كانت قيمة الوسيط length تساوي 0. إن مُرِّرت قيم سالبة للفهارس، فسيُحسَب موضع العنصر بدءًا من نهاية المصفوفة، إذ تمثِّل القيمة ‎-1 فهرس العنصر الأخير. بالنسبة للوسيطين ...

يوزِّع التابع product عناصر المصفوفة التي استدعيت معه على جميع عناصر المصفوفات الممرَّرة إليه. طول المصفوفة الناتجة يساوي جداء طول المصفوفة التي استُدعيت مع التابع بأطوال المصفوفات المُمرّرة إليه. عندما يُستدعى التابع product مع كتلة برمجية، فسيُعِدّ التابع كل التبديلات الممكنة بين عناصر المصفوفات ثم يعيد المصفوفة نفسها. البنية العامة product(other_ary, ...) → new_ary product(other_ary, ...) { |p| block } → ary المعاملات other_ary مصفوفة يراد توزيع عناصر المصفوفة المعطاة على عناصرها. … مصفوفات أخرى يراد توزيع عناصر المصفوفة المعطاة ...

تتضمّن التوابع في لغة روبي الوظائف التي يقوم بها برنامجك. إليك هذا المثال لتعريف تابع بسيط: def one_plus_one  1 + 1 end  تعريف التابع يتكوّن من الكلمة المحجوزة def يتبعها اسم التابع، ثمّ جسم التابع، فالقيمة المعادة وفي النهاية الكلمة المحجوزة end. فعند تنفيذ التابع في المثال السابق، ستُعاد القيمة 2. هذا القسم سيغطّي تعريف التّوابع. ارجع إلى توثيق استدعاء التوابع لتتعرف على الصيغ المستخدمة لذلك الغرض. تسمية التوابع يمكن أن تستخدم لاسم التابع أحد المعاملات، وإلا فعليك أن تبتدئه بحرف أبجديّ أو ...

يحول التابع zip الوسائط الممرَّرة إليه إلى مصفوفات ثم يدمج عناصر المصفوفة التي استُدعيت معه مع العناصر المقابلة في الوسائط (المصفوفات) المُمرَّرة. يولد هذا التابع عددًا من المصفوفات تحوي كلًّا منها n عنصر، إذ n هو عدد الوسائط الممررة مضافًا إليها 1. إن كان حجم أحد الوسائط أصغر من حجم المصفوفة الأصلية، فسيعوض التابع القيمة nil مكان القيم الناقصة. في حال تمرير كتلة برمجية كوسيط، ستُستدعى تلك الكتلة مع كل مصفوفة من المصفوفات الناتجة عن عملية الدمج، وإلا فستعاد تلك ...

يحذف التابع shift أول عنصر أو أول n عنصر من عناصر مصفوفة ثم يعيده أو يعيد مصفوفة تحوي العناصر المحذوفة. إن مرِّر عدد n كوسيط إلى التابع shift، فسيحذف أول n عنصر من المصفوفة ثمَّ يعيدها في مصفوفة جديدة وهذا مشابه تمامًا لاستدعاء التابع slice!‎ بالشكل: array.slice!(0, n)‎. ستحتوي المصفوفة الأصلية حينئذٍ العناصر المتبقية فقط دون العناصر التي أزيحت ووُضعت في المصفوفة الجديدة المُعادة. البنية العامة shift → obj or nil shift(n) → new_ary المعاملات n عدد صحيح يمثل عدد العناصر ...

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

يضيف التابع concat جميع عناصر المصفوفات المُمرّرة إليه إلى المصفوفة التي استُدعيت معه. البنية العامة concat(other_ary1, other_ary2,...) → ary المعاملات other_ary1 المصفوفة الأولى المراد إضافة عناصرها إلى المصفوفة المعطاة. other_ary2 المصفوفة الثانية المراد إضافة عناصرها إلى المصفوفة المعطاة. … المصفوفات الأخرى المراد إضافة عناصرها إلى المصفوفة المعطاة. القيم المعادة تعاد المصفوفة المعطاة بعد إضافة المصفوفات other_ary1 و other_ary2 ...إلخ. المُمرَّرة إلى التابع إليها. أمثلة أمثلة على استخدام التابع concat: [ "a", "b" ].concat( ["c", "d"] ) #=> [ ...

يحذف التابع pop آخر عنصر أو آخر n عنصر من مصفوفة ثم يعيده أو يعيدها في مصفوفة جديدة. البنية العامة pop → obj or nil pop(n) → new_ary المعاملات n عدد صحيح يحدد عدد العناصر الأخيرة التي يراد حذفها من المصفوفة المعطاة. القيم المعادة يعاد العنصر المحذوف من آخر المصفوفة المعطاة، أو مصفوفة جديدة تحوي العناصر n الأخيرة المحذوفة من المصفوفة، أو القيمة nil إن كانت المصفوفة فارغة. أمثلة أمثلة على استخدام التابع pop: a = [ "a", "b", ...

يفترض التابع transpose أنَّ المصفوفة التي استُدعيت معه مكونةٌ من مصفوفات فيعمل على قلب (transposes) الأعمدة إلى أسطر والأسطر إلى أعمدة. البنية العامة transpose → new_ary القيم المعادة تعاد مصفوفة جديدة تحوي المصفوفات الفرعية الموجودة في المصفوفة المعطاة بعد قلب أعمدتها إلى أسطر وأسطرها إلى أعمدة. أمثلة مثالٌ على استخدام التابع transpose: a = [[1,2], [3,4], [5,6]] a.transpose #=> [[1, 3, 5], [2, 4, 6]] انظر أيضًا التابع reverse‎: يعكس ترتيب عناصر المصفوفة التي استُدعيت معه ويضعها في مصفوفة ...

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

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

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

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

تنشئ الدالة new‎‎ مصفوفةً جديدةً. البنية العامة new(size=0, default=nil) new(array) new(size) {|index| block } إن لم تمرَّر أيَّة وسائط إلى الدالة new()‎، فستنشئ مصفوفة جديدة فارغة. إن مُرِّر الوسيطان size و default اللذان يمثلان حجم المصفوفة والقيم الأولية لعناصرها، فستُنشَأ مصفوفة جديدة حجمها size ومكونة من القيم default المعطاة. لاحظ أنَّ جميع العناصر تشير إلى الكائن default نفسه. first_array = ["Matz", "Guido"] تنشئ الدالة new()‎ أيضًا نسخة من مصفوفة أخرى عبر تمريرها كوسيط (تنشئ تلك المصفوفة عبر استدعاء التابع ‎ to_ary‎ مع الوسيط المعطى). ...

يعيد التابع reject مصفوفة جديدة تحتوي جميع عناصر المصفوفة التي استُدعيت معها والتي لم تحقق شرطًا محددًا. يُحافَظ على ترتيب العناصر المرفوضة المعادة بنفس ترتيبها كما كانت في المصفوفة الأصلية. إن لم تُمرَّر أية كتلة إلى التابع reject، فسيعيد كائنًا من النوع Enumerator. البنية العامة reject {|item| block } → new_ary reject → Enumerator القيم المعادة تعاد مصفوفة جديد تحوي جميع عناصر المصفوفة المعطاة التي لم تعاد معها القيمة true عند تطبيق الكتلة block عليها، أو يعاد كائن من النوع ...

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

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

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

يعكس التابع reverse!‎ ترتيب عناصر المصفوفة التي استُدعيت معه. البنية العامة reverse! → ary القيم المعادة تعاد المصفوفة نفسها المعطاة بعد عكس ترتيب عناصرها. أمثلة أمثلة على استخدام التابع reverse!‎: a = [ "a", "b", "c" ] a.reverse! #=> ["c", "b", "a"] a #=> ["c", "b", "a"] انظر أيضًا التابع reverse: يعكس ترتيب عناصر المصفوفة التي استُدعيت معه ويضعها في مصفوفة ...

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

يضيف التابع unshift الكائنات المُمرَّرة إليه إلى بداية المصفوفة التي استُدعيت معه مع إزاحة العناصر الأخرى إلى الأمام. البنية العامة unshift(obj, ...) → ary المعاملات obj الكائن المراد إضافته في بداية المصفوفة المعطاة. … الكائنات الأخرى المراد إضافتها في بداية المصفوفة المعطاة. القيم المعادة تعاد المصفوفة نفسها المعطاة بعد إضافة الكائن obj والكائنات الأخرى الممررة إلى بدايتها. أمثلة بعض أمثلة على استخدام التابع unshift: a = [ "b", "c", "d" ] a.unshift("a") #=> ["a", "b", "c", "d"] a.unshift(1, 2) ...

يبحث التابع 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 مجالًا، فستُجلَب العناصر التي تقع فهارسها ضمن ذلك المجال وتوضع في المصفوفة المعادة. إن وقع فهرس عنصر خارج مجال ...