نتائج البحث

يجلب التابع 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 ...