التابع Array.join في روبي

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث

يجمع التابع join جميع عناصر المصفوفة التي استُدعيت معها سويةً في سلسلة نصية ويفصل بينها بفاصل معين.

البنية العامة

 join(separator=$,)  str

المعاملات

separator

المحرف الذي يراد استعماله كفاصل بين عناصر المصفوفة عند وضعها في سلسلة نصية. إن كانت قيمة هذا الفاصل هي nil، فسيستخدم التابع المحرف $ الافتراضي. أما إن كانت قيمة كلٍّ من separator و $ هي nil، فسيستخدم التابع سلسلة نصية فارغة كفاصل.

القيم المعادة

تعاد سلسلة نصية تحوي جميع عناصر المصفوفة المعطاة مفصولةً بالفاصل separator.

أمثلة

أمثلة على استخدام التابع join:

 [ "a", "b", "c" ].join        #=> "abc"
[ "a", "b", "c" ].join("-")   #=> "a-b-c"
[ "a", [1, 2, [:x, :y]], "b" ].join("-")   #=> "a-1-2-x-y-b"

انظر أيضًا

  • التابع sum: يجمع عناصر المصفوفة التي استُدعيت معه مع بعضها بعضًا.
  • المعامل -: يعيد مصفوفة جديدة تمثل نسخة من جميع عناصر المصفوفة الأصلية باستثناء العناصر المشتركة مع المصفوفة other_ary الأخرى.
  • المعامل +: يجمع مصفوفتين معًا في مصفوفة واحدة جديدة
  • المعامل *: إن استعمل مع مصفوفة ary وسلسلة نصية str، فسيُكافئ حينئذٍ العبارة ary.join(str)‎. أمَّا إن استعمل مع مصفوفة ary وعدد int، فسيُعيد مصفوفة جديدة تتكرر فيها المصفوفة تلك عددًا من المرات مساويًا لذلك العدد المعطى.

مصادر