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