الدالة ‎‎jQuery.merge()‎‎ في jQuery

من موسوعة حسوب
< jQuery‏ | jQuery
اذهب إلى: تصفح، ابحث

jQuery.merge( first, second )‎

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

تعيد مصفوفةً (Array).

الوصف

تدمج هذه الدالة محتوى مصفوفتين مع بعضهما بعضًا وتضع الناتج في المصفوفة الأولى.

jQuery.merge( first, second )‎

أُضيفت مع الإصدار: 1.0.

first

الكائن الأول الشبيه بالمصفوفة المراد دمج محتواه، إذ سيضاف محتوى الوسيط الثاني إليه.

second

الكائن الثاني الشبيه بالمصفوفة المراد دمج محتواه، إذ سيضاف محتواه إلى الوسيط الأول.

تدمج الدالة ‎$.merge()‎ جميع محتويات المصفوفتين الممرَّرتين إليه في مصفوفة واحدة مع الحفاظ على ترتيب محتواهما، إذ تضاف محتويات المصفوفة الثانية إلى نهاية المصفوفة الأولى. تُعدُّ الدالة ‎$.merge()‎ مدمرة، إذ تُغيِّر قيمة الخاصِّيَّتين length والفهرس الرقمي (numeric index) للوسيط الأول المعطى من أجل إضافة عناصر إليه من الوسيط الثاني.

إن أردت الحفاظ على المصفوفة الأولى دون تعديل، فأنشئ نسخةً منها ثمَّ استعمل هذه النسخة مع الدالة ‎$.merge()‎؛ فمن حسن الحظ أنَّه يمكن استعمال الدالة نفسها من أجل إنشاء نسخة من مصفوفة:
var newArray = $.merge([], oldArray);
ينشئ الاختصار [] مصفوفةً جديدةً فارغةً ويضع التابع محتويات المصفوفة الأصليَّة التي لا نرغب بتعديلها فيها لاستعمالها لاحقًا.

قبل الإصدار jQuery 1.4، يجب أن يُستعمَل مع هذا التابع مصفوفات حقيقيَّة (وليس كائنات شبيه بمصفوفات). إن لم يكن أحد الوسيطين أو كلاهما مصفوفةً حقيقيَّةً، فاستعمل التابع ‎$.makeArray()‎ لتحويلهما.

أمثلة

دمج مصفوفتين في مصفوفة واحدة مع تعديل المصفوفة الأولى:
$.merge( [ 0, 1, 2 ], [ 2, 3, 4 ] )
ستُظهر هذه الشيفرة النتيجة التالية:
[ 0, 1, 2, 2, 3, 4 ]
دمج مصفوفتين في مصفوفة واحدة دون تعديل المصفوفة الأولى:
var first = [ "أ", "ب", "ت" ];
var second = [ "ث", "ج", "ح" ];

$.merge( $.merge( [], first ), second );
ستُظهر هذه الشيفرة النتيجة التالية:
‎[ "أ"‎, "ب", ‎‎"ت"‎, "ث"‎, ‎"ج"‎, "ح" ]

مصادر