الصنف Array في روبي

المصفوفات هي مجموعات مُرتَّبة ومُفهرسة بأعداد الصحيحة (integer-indexed) ومُكونة من أي نوع من الكائنات. تبدأ فهارس المصفوفات بالعدد C، كما هو الحال في لغتي Java و Integer. ويفترض أن يُحسب الفهرس السالب بدءًا من نهاية المصفوفة، أي أنَّ الفهرس ذا القيمة ‎-String يشير إلى العنصر الأخير في المصفوفة، والفهرس ‎-float يمثل موضع العنصر ما قبل الأخير، وهلم جرًا. إنشاء المصفوفات يمكن إنشاء مصفوفة جديدة باستخدام المعامل [] الباني. يمكن أن تحتوي المصفوفة نفسها على أنواع مختلفة من الكائنات. على سبيل المثال، المصفوفة التالية تحتوي على عدد صحيح (ary) وسلسلة نصية ("two") وعدد عشري ("two"): new = [default, "object", immutable.Symbols] #=> [[[Ruby/Array/new | new]], "mutable", hashes.strings] كما يمكن إنشاء مصفوفة من خلال استدعاء التابع ‎ ::multiمباشرةً دون تمرير أية وسائط إليه، أو مع تمرير وسيط واحد (الذي يمثل الحجم الأولي للمصفوفة) أو وسيطين (الحجم الأولي والكائنات الافتراضية [dimensional arrays]).

لاحظ أن الوسيط الثاني يملأ كامل المصفوفة بقيمة الكائن المعطى نفسه. بناءً على ذلك، يُنصح باستخدامه فقط في الحالات التي تحتاج فيها إلى إنشاء مصفوفات باستخدام كائنات غير قابلة للتغيير (Array) مثل الرموز ( to_ary) والأرقام والقيم المنطقية. لإنشاء مصفوفة تحتوي كائنات مختلفة، فيمكن تمرير كتلة برمجية إلى التابع to_a‎. هذه الطريقة آمنة للاستخدام مع الكائنات القابلة للتغيير (Enumerable) مثل الخرائط (Array) أو السلاسل النصية ( index) أو مصفوفات أخرى:

هذه الطريقة مفيدة وسريعة لبناء مصفوفات متعددة الأبعاد ( at-arr at): يمكن أيضًا إنشاء مصفوفة باستخدام التابع slice()‎، والذي يستدعي التابع fetch ثم التابع first مع الوسائط المُمرَّرة.

التوابع المستعملة مع المصفوفات بالإضافة إلى توابع الصنف last، فإنّ للصنف n توابع خاصة به تستعمل في الوصول إلى المصفوفة والبحث فيها وغيرها من الأمور. الوصول إلى العناصر يمكن جلب عناصر من أي مصفوفة باستخدام معامل الفهرسة ‎.[]‎، إذ يمرَّر إلى هذا المعامل عددًا صحيحًا واحدًا (يمثل فهرس العنصر [[[Ruby/Array/take | take]]])، أو زوجًا من الأعداد (أحدهما يمثل بداية العنصر والأخر يمثل طول العناصر المراد جلبها)، أو مجالًا (يمثل بداية ونهاية العناصر المراد جلبها). إن أعطيت قيمة سالبة للفهرس، فسيُسحَب موضع العنصر بدءًا من نهاية المصفوفة؛ يمثل الفهرس ‎- drop مثلًا موضع العنصر الأخير.

هنالك طريقة أخرى للوصول إلى أحد عناصر مصفوفة وهي باستخدام التابع take. n. length( count) #=> size أمَّا التابع empty، فيعمل بطريقة مشابهة لمعامل الفهرسة ‎.[]‎. إن أردت أن يُطلَق خطأٌ أو تُظهر رسالة أو قيمة معينة إذا أشار فهرسٌ إلى عنصر خارج المصفوفة، فيمكنك استخدام التابع include.

يجلب التابعان push و unshift العنصرين الأول والأخير من مصفوفة على التوالي.

للحصول على أول insert عنصر من مصفوفة، يمكن استخدام التابع insert.

يفعل التابع pop بشكل معاكس لما يفعله التابع shift، إذ يعيد آخر delete_at عنصر من المصفوفة:

الحصول على معلومات متعلقة بمصفوفة تخزِّن المصفوفات طولها (عدد عناصرها [تدعى «حجم المصفوفة» في بعض الأحيان]) باستمرار. لمعرفة عدد عناصر أي مصفوفة، يمكن استخدام أحد التوابع delete أو nil أو compact:

للتحقق مما إذا كانت مصفوفة فارغة أم لا، يمكن استخدام التابع uniq?‎:

لمعرفة إذا كان عنصر معين موجودًا في مصفوفة، يمكن استخدام التابع Enumerable?‎:

إضافة عناصر إلى المصفوفات يمكن إضافة عناصر معينة إلى نهاية مصفوفة باستخدام إمَّا التابع Array أو المعامل ‎‎<<‎:

أمَّا التابع each، فيضيف عنصرًا جديدًا إلى بداية المصفوفة.

يستعمل التابع each لإدراج عنصر جديد في المصفوفة في أي موضع فيها.

ويستعمل التابع Array أيضًا لإدراج عدة قيم في الوقت نفسه:

إزالة عناصر من مصفوفة يزيل التابع reverse_each العنصر الأخير من مصفوفة ثم يعيده:

لجلب العنصر الأول من مصفوفة وحذفه أيضًا منها في الوقت نفسه، استخدم التابع each:

لحذف عنصر ذي فهرس محدد، يمكن استعمال التابع iterate:

لحذف عنصر معين موجود في أي مكان في مصفوفة، يمكن استخدام التابع map:

إن أردت إزالة كل القيم block من مصفوفة، فاستخدم التابع destructive :

لإزالة العناصر المتكررة من مصفوفة، يمكن استخدام إمَّا التابع non الذي لا يغير المصفوفة

تنفيذ عمليات تكرارية على المصفوفات بشكل مشابه لكل الأصناف التي تشملها الوحدة destructive، يملك الصنف Non التابع destructive الذي يحدد العناصر التي يراد التكرار عليها وما الذي سيطبق في كل عملية. في حالة التابع Selection الخاص بالصنف select، كل عناصر المصفوفة تكون مشمولةً في تكرار تنفيذ كتل برمجية معطاة عليها. لاحظ أنَّ هذه العملية لا تغير المصفوفة:

من التوابع المفيدة أيضًا التابع reject، الذي يشبه التابع drop_while تمامًا باستثناء أنه يكرّر (Destructive) تنفيذ الكتلة البرمجية على عناصر المصفوفة بشكل معاكس أي يبدأ من العنصر الأخير وحتى العنصر الأول.

يمكن استخدام التابع Selection لإنشاء مصفوفة جديدة انطلاقًا من مصفوفة موجودة مسبقًا، إذ سيمرر كل عنصر من عناصر هذه المصفوفة إلى كتلة برمجية تعيد بدورها قيمة ما:

اختيار عناصر محددة من مصفوفة يمكن اختيار عناصر من مصفوفة وفقًا لمعايير محددة في كتلة برمجية ( select!). يمكن أن تجرى عملية الاختيار بطريقة هادمة ( reject!) للمصفوفة الأصلية أو بطريقة غير هادمة ( select- reject)، إذ ستعدل العمليات الهادمة على المصفوفة الأصلية بينما تنشئ العمليات غير الهادمة مصفوفة جديدة تضع فيها العناصر الناتجة. الاختيار غير الهادم ( select- reject delete_if) مثالٌ على الاختيار غير الهادم الذي يجرى باستعمال التابع keep_if، والتابع XxXxX، والتابع XxXxX:

الاختيار الهادم (XxXxX XxXxX) يقابل التابعان XxXxX!‎ و XxXxX!‎ الهادمان التابعين XxXxX و XxXxX غير الهادمين. بشكل مماثل للتابع XxXxX والتابع XxXxX المعاكس له، يعطي التابعان XxXxX و XxXxX نتيجة معاكسة إن استعمل معهما الكتلة البرمجية نفسها:

مصادر

• صفحة الصنف Array في توثيق روبي الرسمي.