الفرق بين المراجعتين ل"Ruby/Array/join"
اذهب إلى التنقل
اذهب إلى البحث
(أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: التابع <code>Array.join</code> في روبي}}</noinclude> تصنيف: Ruby تصنيف: Ruby Method [[تصنيف: Ruby Array]...') |
جميل-بيلوني (نقاش | مساهمات) ط |
||
| (مراجعتان متوسطتان بواسطة مستخدم واحد آخر غير معروضتين) | |||
| سطر 8: | سطر 8: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
==المعاملات== | ==المعاملات== | ||
| − | <code>separator</code> | + | |
| − | المحرف الذي يراد استعماله كفاصل بين عناصر المصفوفة عند وضعها في سلسلة نصية. إن كانت قيمة هذا الفاصل هي <code>nil</code>، فسيستخدم التابع المحرف $ الافتراضي. أما إن كانت قيمة كلٍّ من <code>separator</code> و $ هي <code>nil</code>، فسيستخدم التابع سلسلة نصية فارغة كفاصل. | + | === <code>separator</code> === |
| + | المحرف الذي يراد استعماله كفاصل بين عناصر المصفوفة عند وضعها في سلسلة نصية. إن كانت قيمة هذا الفاصل هي <code>nil</code>، فسيستخدم التابع المحرف <code>$</code> الافتراضي. أما إن كانت قيمة كلٍّ من <code>separator</code> و <code>$</code> هي <code>nil</code>، فسيستخدم التابع سلسلة نصية فارغة كفاصل. | ||
==القيم المعادة== | ==القيم المعادة== | ||
تعاد سلسلة نصية تحوي جميع عناصر المصفوفة المعطاة مفصولةً بالفاصل <code>separator</code>. | تعاد سلسلة نصية تحوي جميع عناصر المصفوفة المعطاة مفصولةً بالفاصل <code>separator</code>. | ||
| سطر 16: | سطر 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" | ||
| − | |||
[ "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/plus|+]]</code>: يجمع مصفوفتين معًا في مصفوفة واحدة جديدة | ||
| + | |||
| + | *المعامل <code>[[Ruby/Array/star|*]]</code>: إن استعمل مع مصفوفة <code>ary</code> وسلسلة نصية <code>str</code>، فسيُكافئ حينئذٍ العبارة <code>ary.join(str)</code>. أمَّا إن استعمل مع مصفوفة <code>ary</code> وعدد <code>int</code>، فسيُعيد مصفوفة جديدة تتكرر فيها المصفوفة تلك عددًا من المرات مساويًا لذلك العدد المعطى. | ||
==مصادر== | ==مصادر== | ||
| − | * قسم التابع join في الصنف Array في توثيق روبي الرسمي. | + | * [https://ruby-doc.org/core-2.5.1/Array.html#method-i-join قسم التابع join في الصنف Array في توثيق روبي الرسمي.] |
المراجعة الحالية بتاريخ 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، فسيُعيد مصفوفة جديدة تتكرر فيها المصفوفة تلك عددًا من المرات مساويًا لذلك العدد المعطى.