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

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

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

 join(separator=$,) → str

المعاملات

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

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

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

أمثلة

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

 [ "a", "b", "c" ].join        #=> "abc"
[ "a", "b", "c" ].join("-")   #=> "a-b-c"
بالنسبة للمصفوفات المتشعبة، يُطبّق التابع join بشكل تعاودي (recursively):
[ "a", [1, 2, [:x, :y]], "b" ].join("-")   #=> "a-1-2-x-y-b"

انظر أيضًا

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

مصادر

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