الفرق بين المراجعتين ل"Ruby/Array/join"

من موسوعة حسوب
< Ruby‏ | Array
اذهب إلى التنقل اذهب إلى البحث
ط
 
(مراجعة متوسطة واحدة بواسطة مستخدم واحد آخر غير معروضة)
سطر 10: سطر 10:
  
 
=== <code>separator</code> ===
 
=== <code>separator</code> ===
المحرف الذي يراد استعماله كفاصل بين عناصر المصفوفة عند وضعها في سلسلة نصية. إن كانت قيمة هذا الفاصل هي <code>nil</code>، فسيستخدم التابع المحرف $ الافتراضي. أما إن كانت قيمة كلٍّ من <code>separator</code> و $ هي <code>nil</code>، فسيستخدم التابع سلسلة نصية فارغة كفاصل.
+
المحرف الذي يراد استعماله كفاصل بين عناصر المصفوفة عند وضعها في سلسلة نصية. إن كانت قيمة هذا الفاصل هي <code>nil</code>، فسيستخدم التابع المحرف <code>$</code> الافتراضي. أما إن كانت قيمة كلٍّ من <code>separator</code> و <code>$</code> هي <code>nil</code>، فسيستخدم التابع سلسلة نصية فارغة كفاصل.
 
==القيم المعادة==
 
==القيم المعادة==
 
تعاد سلسلة نصية تحوي جميع عناصر المصفوفة المعطاة مفصولةً بالفاصل <code>separator</code>.
 
تعاد سلسلة نصية تحوي جميع عناصر المصفوفة المعطاة مفصولةً بالفاصل <code>separator</code>.
سطر 17: سطر 17:
 
<syntaxhighlight lang="ruby"> [ "a", "b", "c" ].join        #=> "abc"
 
<syntaxhighlight lang="ruby"> [ "a", "b", "c" ].join        #=> "abc"
 
[ "a", "b", "c" ].join("-")  #=> "a-b-c"
 
[ "a", "b", "c" ].join("-")  #=> "a-b-c"
بالنسبة للمصفوفات المتشعبة، يُطبّق التابع join بشكل تعاودي (recursively):
 
 
[ "a", [1, 2, [:x, :y]], "b" ].join("-")  #=> "a-1-2-x-y-b"
 
[ "a", [1, 2, [:x, :y]], "b" ].join("-")  #=> "a-1-2-x-y-b"
 
  </syntaxhighlight>
 
  </syntaxhighlight>
 
==انظر أيضًا==
 
==انظر أيضًا==
* التابع [[Ruby/Array/sum | <code>sum</code>]]: يجمع عناصر المصفوفة التي استُدعيت معه مع بعضها بعضًا.
+
* التابع<nowiki/>[[Ruby/Array/sum | <code>sum</code>]]: يجمع عناصر المصفوفة التي استُدعيت معه مع بعضها بعضًا.
  
 
* المعامل <code>[[Ruby/Array/minus|-]]</code>: يعيد مصفوفة جديدة تمثل نسخة من جميع عناصر المصفوفة الأصلية باستثناء العناصر المشتركة مع المصفوفة <code>other_ary</code> الأخرى.
 
* المعامل <code>[[Ruby/Array/minus|-]]</code>: يعيد مصفوفة جديدة تمثل نسخة من جميع عناصر المصفوفة الأصلية باستثناء العناصر المشتركة مع المصفوفة <code>other_ary</code> الأخرى.

المراجعة الحالية بتاريخ 07:42، 3 أكتوبر 2018

يجمع التابع 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، فسيُعيد مصفوفة جديدة تتكرر فيها المصفوفة تلك عددًا من المرات مساويًا لذلك العدد المعطى.

مصادر