()Array.prototype.join

دالة ()join تقوم بدمج جميع عناصر المصفوفة في نص واحد.

var a = ['Wind', 'Rain', 'Fire'];
a.join();    // 'Wind,Rain,Fire'
a.join('-'); // 'Wind-Rain-Fire'

صيغة الكتابة

str = arr.join([separator = ','])

المعاملات

separator

اختياري. يحدد النص الذي سيقوم بفصل عناصر المصفوفة عن بعضهم البعض. الـ separator سيتحول إلى جزء من النص الناتج. إذا لم يتم تمريره، سيتم الفصل بين عناصر المصفوفة بالـ comma. إذا كان الـseparator عبارة عن نص فارغ، سيتم ضم عناصر المصفوفة دون أي فاصل

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

عناصر المصفوفة مضمومين في هيئة نص.

الوصف

تقوم بدمج عناصر المصفوفة في هيئة نص، إذا كان أحد هذه العناصر قيمة فارغة أو غير معرف سيتم تحويله إلى نص فارغ.

أمثلة

ضم عناصر المصفوفة بأربعة طرق مختلفة

المثال التالي يقوم بإنشاء مصفوفة a ، بها ثلاثة عناصر، ثم يقوم بضم هذه العناصر الثلاثة، ثم يقوم بضم هذه العناصر الثلاثة إلى نص واحد بأربعة طرق: استخدام الـ separator الإفتراضي، ثم باستخدام الـ comma والمسافة، ثم باستخدام علامة الجمع وأخيرا باستخدام نص فارغ.

var a = ['Wind', 'Rain', 'Fire'];
var myVar1 = a.join();      // myVar1 إلى 'Wind,Rain,Fire' تسند
var myVar2 = a.join(', ');  // myVar2 إلى 'Wind, Rain, Fire' تسند
var myVar3 = a.join(' + '); // myVar3 إلى 'Wind + Rain + Fire' تسند
var myVar4 = a.join('');    // myVar4 إلى 'WindRainFire' تسند

المواصفات

التكامل مع المتصفحات

إقرأ أيضا

• String.prototype.split()
• Array.prototype.toString()
• TypedArray.prototype.join()