الفرق بين المراجعتين ل"Kotlin/ByteArray"

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث
ط
 
(6 مراجعات متوسطة بواسطة مستخدمين اثنين آخرين غير معروضة)
سطر 1: سطر 1:
 +
<noinclude>{{DISPLAYTITLE:الصنف <code>‎‎ByteArray</code>‎ في Kotlin}}</noinclude>يمثل الصنف <code>ByteArray</code> مصفوفةً من البايتات. إن كانت منصة التشغيل المستهدفة هي JVM، فيمكن تمثيل نُسَخ هذا الصنف بالشكل <code>[]byte</code>.<noinclude>{{DISPLAYTITLE:الصنف <code>‎‎ByteArray</code>‎ في Kotlin}}</noinclude><syntaxhighlight lang="kotlin">
 +
class ByteArray
 +
</syntaxhighlight>
 +
 
==الدوال البانية==
 
==الدوال البانية==
 
<code>[[Kotlin/ByteArray/Init|<int>]]</code>
 
<code>[[Kotlin/ByteArray/Init|<int>]]</code>
  
ينشِئ التابع <code>ByteArray()‎</code> مصفوفةً من النوع <code>ByteArray</code> بحجم <code>size</code> مُحدَّدٍ، بحيث كل العناصر تساوي <code>0</code>، وفي حال تمرير دالة كوسيط فسيُحسَب كلُّ عنصرٍ فيها عبر استدعاء الدالة <code>init</code> المُحدَّدة، والتي تُعيد عنصرًا في المصفوفة بحسب الفهرس (index) المُعطى.
+
تنشئ الدالة <code>ByteArray()‎</code> البانية <nowiki/>[[Kotlin/Array|مصفوفة]] جديدة من النوع <code>ByteArray</code> (أي حجم كل عنصر منها بايتًا واحدًا) بحجم معين، إذ تحوي قيمًا محدَّدة أو القيم 0.
 
==الخاصيات==
 
==الخاصيات==
 
===<code>[[Kotlin/ByteArray/size|size]]</code>===
 
===<code>[[Kotlin/ByteArray/size|size]]</code>===
تعبِّر الخاصيّة <code>size‎</code> عن عدد العناصر الموجودة في المصفوفة (<code>ByteArray</code>).
+
تمثِّل الخاصيّة <code>size</code> عدد العناصر الموجودة في المصفوفة ذات النوع <code>ByteArray</code>.
 
==الدوال==
 
==الدوال==
 
===<code>[[Kotlin/ByteArray/get|get]]</code>===
 
===<code>[[Kotlin/ByteArray/get|get]]</code>===
يعيد التابع <code>get()‎</code> قيمة العنصر في المصفوفة عند الفهرس (index) المُحدَّد، ويمكن أيضًا استدعاء هذا التابع باستخدام معامل الفهرسة (index operator) المتمثل بالقوسين <code>[]</code> بالشكل:
+
يجلب التابع <code>get()‎</code> عنصرًا ذي فهرس محدد من المصفوفة.
  
 
===<code>[[Kotlin/ByteArray/iterator|iterator]]</code>===
 
===<code>[[Kotlin/ByteArray/iterator|iterator]]</code>===
يعيد التابع <code>iterator()‎</code> عنصرًا تكراريًّا (iterator) بهدف تكرار بنيةٍ (block) برمجيةٍ على كافّة عناصر المصفوفة.
+
ينشئ التابع <code>iterator()‎</code> عنصرًا تكراريًّا (iterator) لتكرار بنيةٍ (block) برمجيةٍ على كافّة عناصر المصفوفة المستدعاة معه.
  
 
===<code>[[Kotlin/ByteArray/set|set]]</code>===
 
===<code>[[Kotlin/ByteArray/set|set]]</code>===
يعين التابع <code>set()</code> قيمة العنصر في المصفوفة عند الفهرس (index) المُحدَّد، ويمكن أيضًا استدعاء هذا التابع باستخدام معامل الفهرسة (index operator) المتمثل بالقوسين <code>[]</code> بالشكل:
+
يضبط التابع <code>set()</code>‎ قيمة عنصر ذي فهرس محدد موجود في المصفوفة المستدعاة معه.
  
 
== الدوال الموروثة==
 
== الدوال الموروثة==
 
===<code>[[Kotlin/Any/equals|equals]]</code>===
 
===<code>[[Kotlin/Any/equals|equals]]</code>===
تبين الدالة <code>equals()</code>‎ إذا ما كان الكائن المُمرّر إليها يساوي الكائن الذي استدعيت عبره.
+
تحدد الدالة <code>equals()</code>‎ إذا ما كان الكائن المُمرّر إليها يساوي الكائن الذي استدعيت معها.
 
===<code>[[Kotlin/Any/hashCode|hashCode]]</code>===
 
===<code>[[Kotlin/Any/hashCode|hashCode]]</code>===
يعيد التابع <code>hashCode()</code>‎ قيمة الشيفرة hash code الخاصّة بالكائن الذي استُدعي عبره.
+
تعيد الدالة <code>hashCode()</code>‎ قيمة الشيفرة Hash الخاصّة بالكائن الذي استُدعي معها.
 
===<code>[[Kotlin/Any/toString|toString]]</code>===
 
===<code>[[Kotlin/Any/toString|toString]]</code>===
===يعيد التابع <code>toString()‎</code> تمثيلًا نصيًا للكائن الذي يُستدعى عبره.===
+
تحول الدالة <code>toString()‎</code> الكائن الذي يُستدعى معها إلى سلسلة نصية.
 +
 
 
==الخاصيات الإضافية (Extension Properties)==
 
==الخاصيات الإضافية (Extension Properties)==
 
===<code>[[Kotlin/collections/indices|indices]]</code>===
 
===<code>[[Kotlin/collections/indices|indices]]</code>===
سطر 28: سطر 33:
  
 
===<code>[[Kotlin/collections/lastIndex|lastIndex]]</code>===
 
===<code>[[Kotlin/collections/lastIndex|lastIndex]]</code>===
تُستخدَم هذه الخاصيّة للحصول على الفهرس (index) الأخير للمصفوفة أو القائمة (list)، أو القيمة ‎<code>-1</code> إن كانت المصفوفة أو القائمة فارغةً.
+
تُستخدَم هذه الخاصيّة لجلب الفهرس (index) الأخير لمصفوفة أو قائمة (list).
 
 
 
==الدوال الإضافية (Extension Functions)==
 
==الدوال الإضافية (Extension Functions)==
 
===<code>[[Kotlin/collections/all|all]]</code>===
 
===<code>[[Kotlin/collections/all|all]]</code>===
تُعيد الدالة <code>all()‎</code> القيمة <code>true</code> إن كانت كافّة عناصر المصفوفة أو المجموعة (collection) التي استُدعيت عبرها تحقق العبارة المنطقية (predicate) المُحدَّدة، أو تعيد القيمة <code>false</code> بخلاف ذلك.
+
تتحقق الدالة <code>all()‎</code> إن كانت كافّة عناصر المصفوفة أو المجموعة (collection) التي استُدعيت عبرها تطابق شرطًا منطقيًّا محدَّدًا.
 
 
 
===<code>[[Kotlin/collections/any|any]]</code>===
 
===<code>[[Kotlin/collections/any|any]]</code>===
 
يختلف سلوك الدالة <code>any()‎</code> بحسب طريقة استدعائها، وسنناقش هذه الحالات تباعًا.
 
يختلف سلوك الدالة <code>any()‎</code> بحسب طريقة استدعائها، وسنناقش هذه الحالات تباعًا.
 
 
===<code>[[Kotlin/collections/asIterable|asIterable]]</code>===
 
===<code>[[Kotlin/collections/asIterable|asIterable]]</code>===
 
تُنشِئ الدالة <code>asIterable()‎</code>نسخةً تكراريّةً (iterable instance) تُغلّف (wrap) المصفوفة الأصلية وتعيد عناصرَها عندما تُستخدَم في حلقات التكرار (مثل <code>[[Kotlin/control flow#.D8.AA.D8.B9.D8.A8.D9.8A.D8.B1 for|for]]</code>).
 
تُنشِئ الدالة <code>asIterable()‎</code>نسخةً تكراريّةً (iterable instance) تُغلّف (wrap) المصفوفة الأصلية وتعيد عناصرَها عندما تُستخدَم في حلقات التكرار (مثل <code>[[Kotlin/control flow#.D8.AA.D8.B9.D8.A8.D9.8A.D8.B1 for|for]]</code>).
 
+
===<code>[[Kotlin/collections/asList|asList]]</code>===
===<code>[[Kotlin/collections/asList|a]]</code>===
+
تُعيد الدالة <code>asList()‎</code> قائمةً (list) تُغلّف المصفوفة الأصلية التي استُدعيت عبرها.
===تُعيد الدالة <code>asList()‎</code> قائمةً (list) تُغلّف المصفوفة الأصلية التي استُدعيت عبرها.<code>[[Kotlin/collections/asList|sList]]</code>===
 
 
===<code>[[Kotlin/collections/asSequence|asSequence]]</code>===
 
===<code>[[Kotlin/collections/asSequence|asSequence]]</code>===
 
تُنشِئ الدالة <code>asSequence()‎</code> نسخةً (instance) من النوع <code>sequence</code> والتي تُغلّف المصفوفة الأصلية وتعيد عناصرها عندما تُستخدَم في حلقات التكرار (مثل حلقة <code>[[Kotlin/control flow#.D8.AA.D8.B9.D8.A8.D9.8A.D8.B1 for|for]]</code>).
 
تُنشِئ الدالة <code>asSequence()‎</code> نسخةً (instance) من النوع <code>sequence</code> والتي تُغلّف المصفوفة الأصلية وتعيد عناصرها عندما تُستخدَم في حلقات التكرار (مثل حلقة <code>[[Kotlin/control flow#.D8.AA.D8.B9.D8.A8.D9.8A.D8.B1 for|for]]</code>).
 
 
===<code>[[Kotlin/collections/associate|associate]]</code>===
 
===<code>[[Kotlin/collections/associate|associate]]</code>===
تعيد الدالة <code>associate()‎</code> خريطةً (map) تحوي أزواجًا من "مفتاح/قيمة" ناتجة عن تمرير عناصر المصفوفة أو المجموعة ([[Kotlin/collections|Collection]]) إلى الدالة<code>()transform</code>.
+
تعيد الدالة <code>associate()‎</code> خريطةً (map) تحوي أزواجًا من "مفتاح/قيمة" ناتجة عن تمرير عناصر المصفوفة أو المجموعة ([[Kotlin/collections|Collection]]) إلى الدالة المررة إليها.
 
 
 
===<code>[[Kotlin/collections/associateBy|associateBy]]</code>===
 
===<code>[[Kotlin/collections/associateBy|associateBy]]</code>===
تعيد الدالة <code>associateBy()‎</code> خريطةً (map) تحتوي على عناصر المصفوفة أو المجموعة ([[Kotlin/collections|Collection]]) المعطاة مفهرسةً بقيمة المفتاح المعاد من تمرير تلك العناصر إلى الدالة <code>valueTransform</code>.
+
تعيد الدالة <code>associateBy()‎</code> خريطةً (map) مكونة من الأزواج "مفتاح/قيمة"، إذ يكون المفتاح (key) هو الناتج الذي تعيده الدالة <code>keySelector</code> الممررة إليها وتكون القيمة (value) المقابلة لذلك المفتاح هي إمَّا عناصر المصفوفة أو المجموعة المعطاة أو الناتج الذي تعيده الدالة <code>valueTransform</code> الممررة.
 
 
 
===<code>[[Kotlin/collections/associateByTo|associateByTo]]</code>===
 
===<code>[[Kotlin/collections/associateByTo|associateByTo]]</code>===
تعيد الدالة <code>associateByTo()‎</code> خريطةً متغيرةً (mutable map) تحتوي على أزواج من "قيمة/مفتاح"، إذ القيمة هي عناصر المصفوفة أو المجموعة ([[Kotlin/collections|Collection]]) المعطاة، والمفتاح هو الناتج المعاد من تمرير تلك العناصر إلى الدالة <code>keySelector</code>.
+
تشبه الدالة <code>associateByTo()‎</code> الدالة <code>[[Kotlin/collections/associateBy|associateBy()‎]]</code> تمامًا باستثناء أنها تضيف الناتج الذي تعيده إلى خريطة موجودة مسبقًا. 
 
 
 
===<code>[[Kotlin/collections/associateTo|associateTo]]</code>===
 
===<code>[[Kotlin/collections/associateTo|associateTo]]</code>===
تعيد الدالة <code>associateTo()‎</code> خريطةً متغيرةً (mutable map) تحتوي على أزواج من "قيمة/مفتاح"، إذ القيمة هي عناصر المصفوفة أو المجموعة ([[Kotlin/collections|Collection]]) المعطاة، والمفتاح هو الناتج المعاد من تمرير تلك العناصر إلى الدالة <code>transform</code>.
+
تشبه الدالة <code>associateTo()‎</code> الدالة <code>[[Kotlin/collections/associate|associate()‎]]</code> تمامًا باستثناء أنها تضيف الناتج الذي تعيده إلى خريطة موجودة مسبقًا.  
 
 
 
===<code>[[Kotlin/collections/average|average]]</code>===
 
===<code>[[Kotlin/collections/average|average]]</code>===
 
تحسب الدالة <code>average()‎</code> متوسط (average) عناصر المصفوفة أو المجموعة ([[Kotlin/collections|Collection]]) المعطاة لها.
 
تحسب الدالة <code>average()‎</code> متوسط (average) عناصر المصفوفة أو المجموعة ([[Kotlin/collections|Collection]]) المعطاة لها.
 
 
===<code>[[Kotlin/collections/binarySearch|binarySearch]]</code>===
 
===<code>[[Kotlin/collections/binarySearch|binarySearch]]</code>===
 
تبحث الدالة <code>binarySearch()‎</code> عن عنصر معين في المجموعة أو مجال من المجموعة ([[Kotlin/collections|Collection]]) باستخدام خوارزميَّة البحث الثنائي (binary search algorithm) وتعيد فهرس موقعه. ويجب أن تكون المجموعة مرتبَّةً وفق المُقارِن <code>comparator</code> وإلا فستكون النتيجة المعادة غير مُحدّدة.
 
تبحث الدالة <code>binarySearch()‎</code> عن عنصر معين في المجموعة أو مجال من المجموعة ([[Kotlin/collections|Collection]]) باستخدام خوارزميَّة البحث الثنائي (binary search algorithm) وتعيد فهرس موقعه. ويجب أن تكون المجموعة مرتبَّةً وفق المُقارِن <code>comparator</code> وإلا فستكون النتيجة المعادة غير مُحدّدة.
 
 
===<code>[[Kotlin/collections/component1|component1]]</code>===
 
===<code>[[Kotlin/collections/component1|component1]]</code>===
 
تعيد الدالة <code>component1()‎</code> العنصر الأول من المصفوفة أو المفتاح (key) لأول زوج (مفتاح/قيمة) في الخريطة (map) التي استدعيت معها. تسمح هذه الدالة باستخدام التصريحات التفكيكية (destructuring declarations) عند العمل على الخرائط. 
 
تعيد الدالة <code>component1()‎</code> العنصر الأول من المصفوفة أو المفتاح (key) لأول زوج (مفتاح/قيمة) في الخريطة (map) التي استدعيت معها. تسمح هذه الدالة باستخدام التصريحات التفكيكية (destructuring declarations) عند العمل على الخرائط. 
 
 
===<code>[[Kotlin/collections/contains|contains]]</code>===
 
===<code>[[Kotlin/collections/contains|contains]]</code>===
 
تتحقق الدالة <code>contains()‎</code> إن كانت <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت معها تحتوي على العنصر الممرّر إليها، أو إن كانت الخريطة التي استدعيت معها تحتوي على ذلك العنصر كمفتاح (key).
 
تتحقق الدالة <code>contains()‎</code> إن كانت <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت معها تحتوي على العنصر الممرّر إليها، أو إن كانت الخريطة التي استدعيت معها تحتوي على ذلك العنصر كمفتاح (key).
 
+
===<code>[[Kotlin/collections/contentDeepEquals|contentDeepEquals]]</code>===
 +
تتحقق الدالة <code>contentDeepEquals()‎</code> من تساوي مصفوفتين بالعُمق، أي أنهما تحتويان على نفس العناصر وبنفس الترتيب.
 +
===<code>[[Kotlin/collections/contentDeepHashCode|contentDeepHashCode]]</code>===
 +
تشِّفر الدالة <code>contentDeepHashCode()‎</code> محتوى <nowiki/>[[Kotlin/Array|المصفوفة]] التي استُدعيت معها كما لو كانت قائمة إلى شيفرة Hash. تعامل <nowiki/>[[Kotlin/Array|المصفوفات]] المُتشعبة مثل القوائم أيضًا.
 +
===<code>[[Kotlin/collections/contentDeepToString|contentDeepToString]]</code>===
 +
تعيد الدالة <code>contentDeepToString()‎</code> سلسلة نصية تمثِّل محتوى <nowiki/>[[Kotlin/Array|المصفوفة]] التي استُدعيت معها كما لو كانت قائمة. تعامل <nowiki/>[[Kotlin/Array|المصفوفات]] المُتشعبة مثل معاملة القوائم أيضًا.
 
===<code>[[Kotlin/collections/contentEquals|contentEquals]]</code>===
 
===<code>[[Kotlin/collections/contentEquals|contentEquals]]</code>===
 
تتحقَّق الدالة <code>contentEquals()‎</code> من تساوي <nowiki/>[[Kotlin/Array|مصفوفتين]] بنيويًا (''structurally'' equal)، أي إن كان لهما نفس العناصر وبنفس العدد والترتيب.
 
تتحقَّق الدالة <code>contentEquals()‎</code> من تساوي <nowiki/>[[Kotlin/Array|مصفوفتين]] بنيويًا (''structurally'' equal)، أي إن كان لهما نفس العناصر وبنفس العدد والترتيب.
 
 
===<code>[[Kotlin/collections/contentHashCode|contentHashCode]]</code>===
 
===<code>[[Kotlin/collections/contentHashCode|contentHashCode]]</code>===
 
تشفِّر الدالة <code>contentHashCode()‎</code> محتوى <nowiki/>[[Kotlin/Array|المصفوفة]] التي استُدعيت معها كما لو كانت قائمة إلى شيفرة Hash.
 
تشفِّر الدالة <code>contentHashCode()‎</code> محتوى <nowiki/>[[Kotlin/Array|المصفوفة]] التي استُدعيت معها كما لو كانت قائمة إلى شيفرة Hash.
 
 
===<code>[[Kotlin/collections/contentToString|contentToString]]</code>===
 
===<code>[[Kotlin/collections/contentToString|contentToString]]</code>===
 
تعيد الدالة <code>contentToString()‎</code> سلسلة نصية تمثِّل محتوى <nowiki/>[[Kotlin/Array|المصفوفة]] التي استُدعيت معها كما لو كانت قائمة.
 
تعيد الدالة <code>contentToString()‎</code> سلسلة نصية تمثِّل محتوى <nowiki/>[[Kotlin/Array|المصفوفة]] التي استُدعيت معها كما لو كانت قائمة.
 
 
===<code>[[Kotlin/collections/copyOf|copyOf]]</code>===
 
===<code>[[Kotlin/collections/copyOf|copyOf]]</code>===
 
تنسخ الدالة <code>copyOf()‎</code> كامل <nowiki/>[[Kotlin/Array|المصفوفة]] التي استُدعيت معها أو جزءًا منها.  
 
تنسخ الدالة <code>copyOf()‎</code> كامل <nowiki/>[[Kotlin/Array|المصفوفة]] التي استُدعيت معها أو جزءًا منها.  
 
 
===<code>[[Kotlin/collections/copyOfRange|copyOfRange]]</code>===
 
===<code>[[Kotlin/collections/copyOfRange|copyOfRange]]</code>===
 
تنسخ الدالة <code>copyOfRange()‎</code> مجالًا محدَّدًا من <nowiki/>[[Kotlin/Array|المصفوفة]] التي استُدعيت معها.
 
تنسخ الدالة <code>copyOfRange()‎</code> مجالًا محدَّدًا من <nowiki/>[[Kotlin/Array|المصفوفة]] التي استُدعيت معها.
 
 
===<code>[[Kotlin/collections/count|count]]</code>===
 
===<code>[[Kotlin/collections/count|count]]</code>===
تعيد الدالة <code>count()‎</code> عدد عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] أو الخريطة التي استُدعيت معها. يمكن تمرير دالة منطقية كمعامل إلى هذه الدالة لعد العناصر التي تحقق شرطًا معينًّا.
+
تعيد الدالة <code>count()‎</code> عدد جميع عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] أو الخريطة التي استُدعيت معها أو العناصر التي تحقق شرطًا معينًا.
 
 
 
===<code>[[Kotlin/collections/distinct|distinct]]</code>===
 
===<code>[[Kotlin/collections/distinct|distinct]]</code>===
تحذف الدالة <code>distinct()‎</code> العناصر المتكررة الموجودة في <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت معها وتعيد الناتج في قائمة. تُرتَّب العناصر في القائمة الناتجة بنفس ترتيبها في المصفوفة أو المجموعة الأصليَّة.
+
تحذف الدالة <code>distinct()‎</code> العناصر المتكررة الموجودة في <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت معها وتعيد الناتج في قائمة.
 
 
 
===<code>[[Kotlin/collections/distinctBy|distinctBy]]</code>===
 
===<code>[[Kotlin/collections/distinctBy|distinctBy]]</code>===
تعيد الدالة <code>distinctBy()‎</code> قائمة تحتوي على العناصر الموجودة في <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/Array|المجموعة]] التي استُدعيت معها والتي تعطي نتيجة مختلفة عند تطبيق الدالة <code>selector</code> عليها فقط. تُرتَّب العناصر في القائمة الناتجة بنفس ترتيبها في المصفوفة أو المجموعة الأصليَّة.
+
تعيد الدالة <code>distinctBy()‎</code> قائمة تحتوي على العناصر الموجودة في <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/Array|المجموعة]] التي استُدعيت معها والتي تعطي نتيجة مختلفة عند تطبيق الدالة <code>selector</code> عليها فقط. 
 
 
 
===<code>[[Kotlin/collections/drop|drop]]</code>===
 
===<code>[[Kotlin/collections/drop|drop]]</code>===
 
تعيد الدالة <code>drop()‎</code> قائمة تحوي جميع عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/Array|المجموعة]] التي استُدعيت معها باستثناء أول <code>n</code> عنصر.
 
تعيد الدالة <code>drop()‎</code> قائمة تحوي جميع عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/Array|المجموعة]] التي استُدعيت معها باستثناء أول <code>n</code> عنصر.
 
 
===<code>[[Kotlin/collections/dropLast|dropLast]]</code>===
 
===<code>[[Kotlin/collections/dropLast|dropLast]]</code>===
 
تعيد الدالة <code>dropLast()‎</code> قائمة تحوي جميع عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/Array|المجموعة]] التي استُدعيت معها باستثناء آخر <code>n</code> عنصر.
 
تعيد الدالة <code>dropLast()‎</code> قائمة تحوي جميع عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/Array|المجموعة]] التي استُدعيت معها باستثناء آخر <code>n</code> عنصر.
 
 
===<code>[[Kotlin/collections/dropLastWhile|dropLastWhile]]</code>===
 
===<code>[[Kotlin/collections/dropLastWhile|dropLastWhile]]</code>===
 
تعيد الدالة <code>dropLastWhile()‎</code> قائمةً تحوي جميع عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت معها باستثناء العناصر الأخيرة التي تحقق شرطًا معيَّنًا.
 
تعيد الدالة <code>dropLastWhile()‎</code> قائمةً تحوي جميع عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت معها باستثناء العناصر الأخيرة التي تحقق شرطًا معيَّنًا.
  
 +
تحتوي جميع عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/Array|المجموعة]] التي استُدعيت عبرها باستثناء العناصر الأخيرة التي تحقق الشرط المنطقي <code>predicate</code> المُمرّر إلى الدالة.
 
===<code>[[Kotlin/collections/dropWhile|dropWhile]]</code>===
 
===<code>[[Kotlin/collections/dropWhile|dropWhile]]</code>===
تعيد الدالة <code>dropLastWhile()‎</code> قائمةً تحوي جميع عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت معها باستثناء العناصر الأولى التي تحقق شرطًا معيَّنًا.
+
تعيد الدالة <code>dropWhile()‎</code> [[Kotlin/List|قائمةً]] تحوي جميع عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت معها باستثناء العناصر الأولى التي تحقق شرطًا معيَّنًا.
 
 
 
===<code>[[Kotlin/collections/elementAt|elementAt]]</code>===
 
===<code>[[Kotlin/collections/elementAt|elementAt]]</code>===
تجلب الدالة <code>elementAt()‎</code> عنصرًا ذي فهرس معيَّن من <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت معها. إن كان فهرس العنصر المعطى خارج حدود <nowiki/>[[Kotlin/Array|المصفوفة]]<nowiki/>أو <nowiki/>[[Kotlin/Array|المجموعة]]، فستُطلق الدالة <nowiki/>[[Kotlin/exceptions|الاستثناء]] [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-index-out-of-bounds-exception/index.html IndexOutOfBoundsException].
+
تجلب الدالة <code>elementAt()‎</code> عنصرًا ذي فهرس معيَّن من <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت معها. 
 
 
 
===<code>[[Kotlin/collections/elementAtOrElse|elementAtOrElse]]</code>===
 
===<code>[[Kotlin/collections/elementAtOrElse|elementAtOrElse]]</code>===
تجلب الدالة <code>elementAtOrElse()‎</code> عنصرًا ذي فهرس معيَّن من <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت معها. إن كان الفهرس المعطى خارج حدود<nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/Array|المجموعة]]، فستُعيد الدالة ناتج استدعاء دالة معينة.
+
تجلب الدالة <code>elementAtOrElse()‎</code> عنصرًا ذي فهرس معيَّن من <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت معها. إن كان الفهرس المعطى خارج حدود <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/Array|المجموعة]]، فستُعيد الدالة ناتج استدعاء دالة معينة.
 
 
 
===<code>[[Kotlin/collections/elementAtOrNull|elementAtOrNull]]</code>===
 
===<code>[[Kotlin/collections/elementAtOrNull|elementAtOrNull]]</code>===
تجلب الدالة <code>elementAtOrNull()‎</code> عنصرًا ذي فهرس معيَّن من <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت معها. إن كان الفهرس المعطى خارج حدود<nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/Array|المجموعة]]، فستُعيد الدالة القيمة العدمية <code>null</code>.
+
تعيد الدالة<code>elementAtOrNull()‎</code> العنصر الموجود عند الفهرس (index) المحدد من <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/Array|المجموعة]] التي استُدعيت عبرها، وفي حال كان ذلك الفهرس خارج حدود <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/Array|المجموعة]] فستُعيد القيمة المعدومة <code>null</code>.
 
 
 
===<code>[[Kotlin/collections/fill|fill]]</code>===
 
===<code>[[Kotlin/collections/fill|fill]]</code>===
 
تبدِّل الدالة <code>fill()‎</code> قيمة جديدة معطاة مكان عناصر محدَّدة في <nowiki/>[[Kotlin/Array|المصفوفة]] أو القائمة التي تستدعى معها.
 
تبدِّل الدالة <code>fill()‎</code> قيمة جديدة معطاة مكان عناصر محدَّدة في <nowiki/>[[Kotlin/Array|المصفوفة]] أو القائمة التي تستدعى معها.
 
 
===<code>[[Kotlin/collections/filter|filter]]</code>===
 
===<code>[[Kotlin/collections/filter|filter]]</code>===
 
ترشِّح الدالة <code>filter()‎</code> عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] أو أزواج الخرائط المعطاة التي تحقِّق شرطًا معيَّنًا ثمّ تعيدها.
 
ترشِّح الدالة <code>filter()‎</code> عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] أو أزواج الخرائط المعطاة التي تحقِّق شرطًا معيَّنًا ثمّ تعيدها.
 
 
===<code>[[Kotlin/collections/filterIndexed|filterIndexed]]</code>===
 
===<code>[[Kotlin/collections/filterIndexed|filterIndexed]]</code>===
ترشِّح الدالة <code>filterIndexed()‎</code> عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] المعطاة التي أعيدت القيمة <code>true</code> معها عند تطبيق الدالة <code>predicate()‎</code> المُمرّر عليها، إذ يمرَّر فهرس كل عنصر وقيمته إلى الدالة <code>predicate()‎</code> ثم تعيد بدورها قيمة منطقيَّة.
+
ترشِّح الدالة <code>filterIndexed()‎</code> عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] المعطاة بناءً على فهرس العنصر وقيمته.
 
 
 
===<code>[[Kotlin/collections/filterIndexedTo|filterIndexedTo]]</code>===
 
===<code>[[Kotlin/collections/filterIndexedTo|filterIndexedTo]]</code>===
تضيف الدالة <code>filterIndexedTo()‎</code> إلى المجموعة المتغيرة <code>destination</code> المُمرَّر إليها عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] المعطاة التي أعيدت القيمة <code>true</code> مع كل عنصر منها عند تطبيق الدالة <code>predicate()‎</code> المُمرّر عليها. يمرَّر فهرس كل عنصر وقيمته إلى الدالة <code>predicate()</code> ثم تعيد بدورها قيمة منطقيَّة.
+
تشبه الدالة <code>filterIndexedTo()</code>الدالة <nowiki/>[[Kotlin/collections/filterIndexed|<code>filterIndexed()</code>‎]] تمامًا باستثناء أنها تضيف الناتج إلى كائن موجود مسبقًا بدلًا من أن تعيده.  
 
+
===<code>[[Kotlin/collections/filterIsInstance|filterIsInstance]]</code>===
 +
تعيد الدالة <code>filterIsInstance()‎</code> قائمة تحوي عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] المعطاة التي هي نسخةٌ (instance) من نوع أو <nowiki/>[[Kotlin/classes|صنفٍ]] معيّن.
 +
===<code>[[Kotlin/collections/filterIsInstanceTo|filterIsInstanceTo]]</code>===
 +
تضيف الدالة <code>filterIsInstanceTo()‎</code> عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] المعطاة التي هي نسخةٌ (instance) من نوع أو <nowiki/>[[Kotlin/classes|صنفٍ]] معيّن إلى المجموعة المتغيرة <code>destination</code> المُمرّرة إليها.
 
===<code>[[Kotlin/collections/filterNot|filterNot]]</code>===
 
===<code>[[Kotlin/collections/filterNot|filterNot]]</code>===
 +
تعيد الدالة <code>filterNot()‎</code> قائمةً تحوي عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي لم تحقق شرطًا منطقيًّا محدَّدًا.
 +
===<code>[[Kotlin/collections/filterNotNull|filterNotNull]]</code>===
 +
تعيد الدالة <code>filterNotNull()‎</code> جميع عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] المعطاة باستثناء تلك ذات القيمة <code>null</code>.
 +
===<code>[[Kotlin/collections/filterNotNullTo|filterNotNullTo]]</code>===
 +
تشبه الدالة <code>filterNotNullTo()‎</code> الدالة <code>[[Kotlin/collections/filterNotNull|filterNotNull()]]‎</code> في جميع النواحي باستثناء أنَّها تضيف الناتج الذي تعيده إلى المعامل المُمرَّر إليها.
 
===<code>[[Kotlin/collections/filterNotTo|filterNotTo]]</code>===
 
===<code>[[Kotlin/collections/filterNotTo|filterNotTo]]</code>===
تضيف الدالة<code>filterNotTo()‎</code> إلى المعامل <code>destination</code> الممرّر إليها عناصرّ <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت عبرها والتي لا تحقق الشرط المنطقي <code>predicate</code> المُمرّر إليها. من الجدير بالذكر أنّ <code>destination</code> ينبغي أن تكون <nowiki/>[[Kotlin/collections|مجموعة]] قابلة للتغيير (<code>MutableCollection</code>).
+
تشبه الدالة <code>filterNotTo()‎</code> الدالة <code>[[Kotlin/collections/filterNot|filterNot()‎]]</code> في جميع النواحي باستثناء أنَّها تضيف الناتج المعاد إلى المعامل الممرَّر إليها.
 
 
 
===<code>[[Kotlin/collections/filterTo|filterTo]]</code>===
 
===<code>[[Kotlin/collections/filterTo|filterTo]]</code>===
تضيف الدالة<code>filterTo()‎</code> إلى المعامل <code>destination</code> الممرّر إليها عناصرّ <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت عبرها والتي تحقق الشرط المنطقي<code>predicate</code> المُمرّر إليها. من الجدير بالذكر أنّ <code>destination</code> ينبغي أن تكون <nowiki/>[[Kotlin/collections|مجموعة]] قابلة للتغيير (<code>MutableCollection</code>).
+
تشبه هذه الدالة <code>filterTo()‎</code> الدالة <code>[[Kotlin/collections/filter|filter()‎]]</code> في جميع النواحي باستثناء أنها تضيف الناتج إلى المعامل المُمرَّر إليها.
 
 
 
===<code>[[Kotlin/collections/find|find]]</code>===
 
===<code>[[Kotlin/collections/find|find]]</code>===
تعيد الدالة<code>find()‎</code> العنصر الأول من <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت عبرها والذي يحقق الشرط المنطقي <code>predicate</code> المُمرّر إليها. وإن لم يكن هناك أي عنصر يحقق ذلك فستعيد <code>null.</code>
+
تبحث الدالة <code>find()‎</code> على عنصر محدَّد ضمن عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت معها ثمَّ تعيد أول ظهور له.
 
 
 
===<code>[[Kotlin/collections/findLast|findLast]]</code>===
 
===<code>[[Kotlin/collections/findLast|findLast]]</code>===
تعيد الدالة<code>findLast()‎</code> العنصر الأخير من <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت عبرها والذي يحقق الشرط المنطقي <code>predicate</code> المُمرّر إليها. وإن لم يكن هناك أي عنصر يحقق ذلك فستعيد <code>null.</code>
+
تبحث الدالة <code>findLast()‎</code> على عنصر محدَّد ضمن عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت معها ثمَّ تعيد آخر ظهور له.
 
 
 
===<code>[[Kotlin/collections/first|first]]</code>===
 
===<code>[[Kotlin/collections/first|first]]</code>===
تعيد الدالة<code>first()‎</code> العنصر الأول من <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت عبرها، وفي حال تمرير دالة منطقية كمعامل فستعيد أول عنصر يحقق تلك الدالة.
+
تجلب الدالة <code>first()‎</code> أول عنصر من عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت معها إن لم يمرر إليها أي شيء، أو أول عنصر يحق شرطًا معيَّنًا في حال تمرير دالة منطقية إليها.
 
 
 
===<code>[[Kotlin/collections/firstOrNull|firstOrNull]]</code>===
 
===<code>[[Kotlin/collections/firstOrNull|firstOrNull]]</code>===
تعيد الدالة<code>firstOrNull()‎</code> العنصر الأول من <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت عبرها، وفي حال تمرير دالة منطقية كمعامل فستعيد أول عنصر يحقق تلك الدالة.
+
تجلب الدالة <code>firstOrNull()‎</code> أول عنصر من عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت معها إن لم يُمرَّر إليها أي شيء، أو أول عنصر يحقق شرطًا معيَّنًا في حال تمرير دالة منطقية إليها.
 
 
 
===<code>[[Kotlin/collections/flatMap|flatMap]]</code>===
 
===<code>[[Kotlin/collections/flatMap|flatMap]]</code>===
تعيد الدالة<code>flatMap()‎</code> لائحة تضم ناتج تطبيق الدالة <code>transform()‎</code> المُمرّرة إليها على عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت عبرها، وفي حال استدعاء الدالة <code>flatMap()‎</code> على قاموس فستعيد لائحة تضم ناتج تطبيق الدالة <code>transform()‎</code> على مداخل (entries) القاموس.
+
تعيد الدالة <code>flatMap()‎</code> قائمةً تضم ناتج تطبيق الدالة المُمرّرة إليها على عناصر <nowiki/>[[Kotlin/Array|المصفوفة]]، أو <nowiki/>[[Kotlin/collections|المجموعة]]، أو الخريطة التي استُدعيت معها.
 
 
 
===<code>[[Kotlin/collections/flatMapTo|flatMapTo]]</code>===
 
===<code>[[Kotlin/collections/flatMapTo|flatMapTo]]</code>===
تضيف الدالة<code>flatMapTo()‎</code> إلى اللائحة المُتغيرة‎ (<code>MutableCollection‎</code>) ‎<code>destination</code>المُمرّرة إليها ناتج تطبيق الدالة <code>transform()‎</code> على عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت عبرها، وفي حال استدعاء الدالة <code>flatMapTo()‎</code> على قاموس فستضيف إلى اللائحة <code>destination</code> ناتج تطبيق الدالة <code>transform()‎</code> على مداخل (entries) القاموس.
+
تشبه الدالة <code>flatMapTo()‎</code> الدالة <code>[[Kotlin/collections/flatMap|flatMap()‎]]</code> تمامًا باستثناء أنها تضيف الناتج المعاد إلى كائن موجود مسبقًا بدلًا من إعادته فقط.
 
+
===<code>[[Kotlin/collections/flatten|flatten]]</code>===
 +
تعيد الدالة <code>flatten()‎</code> قائمة واحدة تحوي جميع عناصر <nowiki/>[[Kotlin/Array|المصفوفات]] أو <nowiki/>[[Kotlin/collections|المجموعات]] المتشعبة ضمن <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت معها.
 
===<code>[[Kotlin/collections/fold|fold]]</code>===
 
===<code>[[Kotlin/collections/fold|fold]]</code>===
يختلف سلوك الدالة<code>fold()‎</code> حسب نوع الكائنات التي استُدعيت عبرها و نوع المعاملات (parameters) المُمرّرة إليها (انظر فقرة <nowiki/>[[Kotlin/collections/fold#.D8.A7.D9.84.D8.A8.D9.86.D9.8A.D8.A9 .D8.A7.D9.84.D8.B9.D8.A7.D9.85.D8.A9|البنية العامة]]).
+
تجمع الدالة <code>fold()‎</code> تراكميًّا ناتج تطبيق عملية معينة على قيمة كل عنصر من عناصر الكائن المستدعى معها والقيمة التراكمية الحالية بالإضافة إلى قيمة أولية إن أعطيت.
 
 
 
===<code>[[Kotlin/collections/foldIndexed|foldIndexed]]</code>===
 
===<code>[[Kotlin/collections/foldIndexed|foldIndexed]]</code>===
تُراكِم الدالة<code>foldIndexed()‎</code> القيم بدءًا من القيمة المُمرّرة <code>initial</code> وتطبّق العملية <code>operation</code> من اليسار إلى اليمين على القيمة المُتراكمة الراهنة وعلى العنصر التالي من <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت عبرها وكذلك فهرسه. وتُعيد القيمة النهائية.
+
تجمع الدالة <code>foldIndexed()‎</code> ناتج تطبيق عملية معينة على قيمة كل عنصر من عناصر المصفوفة أو المجموعة (بدءًا من اليسار إلى اليمين) المستدعاة معها وفهرس ذلك العنصر بشكل تراكمي بالإضافة إلى القيمة الأولية إن أعطيت.
 
 
 
===<code>[[Kotlin/collections/foldRight|foldRight]]</code>===
 
===<code>[[Kotlin/collections/foldRight|foldRight]]</code>===
تُراكِم الدالة<code>foldRight()‎</code> القيم بدءًا من القيمة المُمرّرة <code>initial</code> وتطبّق العملية <code>operation</code> من اليمين إلى اليسار على القيمة المُتراكمة الراهنة وعلى العنصر التالي من <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت عبرها. وتُعيد القيمة النهائية.
+
تجمع الدالة <code>foldRight()‎</code> بشكل تراكمي ناتج تطبيق عملية معيَّنة على قيمة كل عنصر من عناصر المصفوفة أو المجموعة (بدءًا من اليمين إلى اليسار) المستدعاة معها والقيمة التراكمية الحالية بالإضافة إلى القيمة الأولية إن أعطيت. 
 
 
 
===<code>[[Kotlin/collections/foldRightIndexed|foldRightIndexed]]</code>===
 
===<code>[[Kotlin/collections/foldRightIndexed|foldRightIndexed]]</code>===
تُراكِم الدالة<code>foldRightIndexed()‎</code> القيم بدءًا من القيمة المُمرّرة <code>initial</code> وتطبّق العملية <code>operation</code> من اليمين إلى اليسار على القيمة المُتراكمة الراهنة وعلى العنصر التالي من <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت عبرها وكذلك فهرسه. وتُعيد القيمة النهائية.
+
تجمع الدالة <code>foldRightIndexed()‎</code> ناتج تطبيق عملية معينة على قيمة كل عنصر من عناصر المصفوفة أو المجموعة (بدءًا من اليمين إلى اليسار) المستدعاة معها وفهرس ذلك العنصر بشكل تراكمي بالإضافة إلى القيمة الأولية إن أعطيت.
 
 
 
===<code>[[Kotlin/collections/forEach|forEach]]</code>===
 
===<code>[[Kotlin/collections/forEach|forEach]]</code>===
تُنفّد الدالةُ<code>forEach()‎</code> الدالةَ المُمرّرةَ <code>action</code> على كل عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] أو القاموس الذي استُدعيت عبره.
+
تُنفّد الدالةُ <code>forEach()‎</code> الدالةَ المُمرّرةَ إليها على كل عنصر من عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] أو الخريطة التي استُدعيت معها.
 
 
 
===<code>[[Kotlin/collections/forEachIndexed|forEachIndexed]]</code>===
 
===<code>[[Kotlin/collections/forEachIndexed|forEachIndexed]]</code>===
تُنفّد الدالةُ<code>forEachIndexed()‎</code> الدالةَ المُمرّرةَ <code>action</code> على كل عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] أو القاموس الذي استُدعيت عبره وعلى فهارسها (indices).
+
تُنفّد الدالةُ <code>forEachIndexed()‎</code> الدالةَ المُمرّرةَ إليها على كل عنصر من عناصر <nowiki/>[[Kotlin/Array|المصفوفة]]، أو <nowiki/>[[Kotlin/collections|المجموعة]]، أو الخريطة، التي استُدعيت معها وعلى فهرس ذلك العنصر. 
 
 
 
===<code>[[Kotlin/collections/getOrElse|getOrElse]]</code>===
 
===<code>[[Kotlin/collections/getOrElse|getOrElse]]</code>===
تعيد الدالة <code>getOrElse()‎</code> قيمة العنصر عند الفهرس <code>index</code> المُحدَّد في <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت عبرها. ، أو نتيجة استدعاء الدالة المُمرّرة  <code>defaultValue</code> إن كان الفهرس خارج الحدود.
+
تجلب الدالة <code>getOrElse()‎</code> عنصرًا ذا فهرس مُحدَّد من <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت معها أو القيمة المقابلة لمفتاح محدَّد إن استدعيت مع خريطة.
 
 
 
===<code>[[Kotlin/collections/getOrNull|getOrNull]]</code>===
 
===<code>[[Kotlin/collections/getOrNull|getOrNull]]</code>===
تعيد الدالة <code>getOrNull()‎</code> قيمة العنصر عند الفهرس <code>index</code> المُحدَّد في <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت عبرها. ، أو <code>null</code> إن كان الفهرس خارج الحدود.
+
تجلب الدالة <code>getOrNull()‎</code> عنصرًا ذا فهرس مُحدَّد من <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت معها أو تعيد القيمة <code>null</code> إن كان الفهرس المعطى يقع خارج حدود المصفوفة أو المجموعة.
 
 
 
===<code>[[Kotlin/collections/groupBy|groupBy]]</code>===
 
===<code>[[Kotlin/collections/groupBy|groupBy]]</code>===
تعيد الدالة<code>groupBy()‎</code> قاموسًا يُجمّع عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت عبرها حيث مفاتيحه تعيدها الدالة المُمرّرة <code>keySelector</code> وقيمه لوائحُ تضم عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] (أو ناتج تمرير عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] على الدالة <code>valueTransform</code> في حال تمريرها).
+
تجمِّع الدالة <code>groupBy()‎</code> عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت معها في مجموعات، إذ تطبق دالة محدَّدة على كل عنصر ثمَّ تعاد خريطة تحوي مجموعاتٍ مفتاحُ كلِّ واحدةٍ منها مرتبطٌ بقائمة من العناصر المقابلة.
 
 
 
===<code>[[Kotlin/collections/groupByTo|groupByTo]]</code>===
 
===<code>[[Kotlin/collections/groupByTo|groupByTo]]</code>===
تجمّع الدالة<code>groupByTo()‎</code> عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت عبرها وتضيفها إلى القاموس.المُمرّر <code>destination</code> حيث مفاتيحه تعيدها الدالة الممرّرة <code>keySelector()</code> مُطبّقة على كل عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]]، وقيمُه لوائح تضم العناصر المقابلة، وفي حال تمرير معامل ثالث<code>valueTransform</code> فإنّ القيم ستكون لوائح تضم ناتج تطبيق الدالة <code>valueTransform</code> على العناصر المقابلة . ثم تعيد القاموس<code>destination.</code>
+
تشبه الدالة <code>groupByTo()‎</code> الدالة <code>[[Kotlin/collections/groupBy|groupBy()‎]]</code> في جميع النواحي باستثناء أنَّها تضيف الناتج المعاد إلى المعامل الممرَّر إليها.
 
+
===<code>[[Kotlin/collections/groupingBy|groupingBy]]</code>===
 +
تُنشئ الدالة <code>groupingBy()‎</code> موردًا (source) من النوع <code>Grouping</code> من <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت معها لاستخدامه لاحقًا مع عمليات التجميع (group-and-fold operations) وذلك باستخدام الدالة <code>keySelector</code> المُمرّرة إليها لاستخلاص مفتاح من كل عنصر.
 
===<code>[[Kotlin/collections/indexOf|indexOf]]</code>===
 
===<code>[[Kotlin/collections/indexOf|indexOf]]</code>===
تعيد الدالة <code>indexOf()‎</code> فهرس أول ظهور للعنصر المُمرّر إليها في <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] أو اللائحة التي استُدعيت عبرها ، أو ‎<code>-1‎</code> إن كان العنصر المُمرّر غير موجود.
+
تجلب الدالة <code>indexOf()‎</code> فهرس أول ظهور لعنصر محدَّد من <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] أو القائمة التي استُدعيت معها.
 
 
 
===<code>[[Kotlin/collections/indexOfFirst|indexOfFirst]]</code>===
 
===<code>[[Kotlin/collections/indexOfFirst|indexOfFirst]]</code>===
تعيد الدالة <code>indexOfFirst()‎</code> فهرس أول ظهور للعنصر المُمرّر إليها في <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] أو اللائحة التي استُدعيت عبرها والذي يحقق الشرط المنطقي المُمرّر <code>predicate</code>، أو ‎<code>-1‎</code> إن لم يكن هناك أي عنصر يحقق ذلك.
+
تجلب الدالة <code>indexOfFirst()‎</code> فهرس أول عنصر يحقِّق شرطًا معيَّنًا من <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] أو القائمة التي استُدعيت معها.
 
 
 
===<code>[[Kotlin/collections/indexOfLast|indexOfLast]]</code>===
 
===<code>[[Kotlin/collections/indexOfLast|indexOfLast]]</code>===
تعيد الدالة <code>indexOfLast()‎</code> فهرس آخر ظهور للعنصر المُمرّر إليها في <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] أو اللائحة التي استُدعيت عبرها والذي يحقق الشرط المنطقي المُمرّر <code>predicate</code>، أو ‎<code>-1‎</code> إن لم يكن هناك أي عنصر يحقق ذلك.
+
تجلب الدالة <code>indexOfLast()‎</code> فهرس آخر عنصر يحقِّق شرطًا معيَّنًا من <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] أو القائمة التي استُدعيت معها.
 
 
 
===<code>[[Kotlin/collections/intersect|intersect]]</code>===
 
===<code>[[Kotlin/collections/intersect|intersect]]</code>===
تعيد الدالة <code>intersect()‎</code>مجموعة تحتوي كل العناصر المشتركة بين <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت عبرها وتلك الممرّرة إلى الدالة.
+
تبحث الدالة <code>intersect()‎</code> عن العناصر المشتركة بين مصفوفتين أو مجموعتين ثمَّ تعيدها في مجموعة.
 
+
===<code>[[Kotlin/jvm/isArrayOf|isArrayOf]]</code>===
 +
تتحقَّق الدالة <code>isArrayOf()‎</code> من حواية <nowiki/>[[Kotlin/Array|المصفوفة]] التي استُدعيت معها عناصرَ من نوعٍ محدَّد.
 
===<code>[[Kotlin/collections/isEmpty|isEmpty]]</code>===
 
===<code>[[Kotlin/collections/isEmpty|isEmpty]]</code>===
تعيد الدالة <code>isEmpty()‎</code> القيمة <code>true</code> إن كانت <nowiki/>[[Kotlin/Array|المصفوفة]] التي استُدعيت عبرها فارغةً.
+
تتحقق الدالة <code>isEmpty()‎</code> إن كانت <nowiki/>[[Kotlin/Array|المصفوفة]] التي استُدعيت معها فارغةً أم لا.
 
 
 
===<code>[[Kotlin/collections/isNotEmpty|isNotEmpty]]</code>===
 
===<code>[[Kotlin/collections/isNotEmpty|isNotEmpty]]</code>===
تعيد الدالة <code>isNotEmpty()‎</code> القيمة <code>true</code> إن كانت <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت عبرها غير فارغةً.
+
تتحقَّق الدالة <code>isNotEmpty()‎</code> إن كانت <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت معها فارغةً أم لا.
 
 
 
===<code>[[Kotlin/collections/joinTo|joinTo]]</code>===
 
===<code>[[Kotlin/collections/joinTo|joinTo]]</code>===
تجمّع الدالة<code>joinTo()‎</code> سلسة نصية من عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت عبرها مفصولة بالمعامل المُمرّر <code>separator</code> وباستخدام البادئة<code>prefix</code> واللاحقة <code>postfix</code> في حال تمريرهما،
+
تضيف الدالة <code>joinTo()‎</code> بادئة ولاحقة إلى جميع عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت معها (أو جزءٍ منها) وتفصلها بفاصلة معينة ثمَّ تضيفها إلى سلسة نصية موجودة مسبقًا.
 
 
 
===<code>[[Kotlin/collections/joinToString|joinToString]]</code>===
 
===<code>[[Kotlin/collections/joinToString|joinToString]]</code>===
تنشئ الدالة<code>joinToString()‎</code> سلسة نصية من عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت عبرها مفصولة بالمعامل المُمرّر <code>separator</code> وباستخدام البادئة <code>prefix</code> واللاحقة <code>postfix</code> في حال تمريرهما،
+
تضيف الدالة <code>joinToString()‎</code> بادئة ولاحقة إلى جميع عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت معها (أو جزءٍ منها) بعد فصل عناصرها بفاصلة معينة ثمَّ تضع الناتج في سلسة نصيةجديدة تنشئها آنذاك.
 
 
 
===<code>[[Kotlin/collections/last|last]]</code>===
 
===<code>[[Kotlin/collections/last|last]]</code>===
تعيد الدالة<code>last()‎</code> العنصر الأخير من <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] أو اللائحة التي استُدعيت عبرها. في حال تمرير شرط منطقي <code>predicate</code> كوسيط فستعيد العنصر الأخير الذي يحقق ذلك الشرط.
+
تجلب الدالة <code>last()‎</code> آخر عنصر من عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت معها إن لم يمرر إليها أي شيء، أو آخر عنصر يحق شرطًا معيَّنًا في حال تمرير دالة منطقية إليها.
 
 
 
===<code>[[Kotlin/collections/lastIndexOf|lastIndexOf]]</code>===
 
===<code>[[Kotlin/collections/lastIndexOf|lastIndexOf]]</code>===
تعيد الدالة<code>lastIndexOf()‎</code> آخر فهرس للعنصر الممرّر إلى <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] أو اللائحة التي استُدعيت عبرها. وإن لم يكن العنصر موجودًا فستعيد ‎<code>-1‎</code>.
+
تجلب الدالة <code>lastIndexOf()‎</code> فهرس آخر ظهور لعنصر محدَّد من <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] أو القائمة التي استُدعيت معها.
 
 
 
===<code>[[Kotlin/collections/lastOrNull|lastOrNull]]</code>===
 
===<code>[[Kotlin/collections/lastOrNull|lastOrNull]]</code>===
تعيد الدالة<code>lastOrNull()‎</code> العنصر الأخير من <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] أو اللائحة التي استُدعيت عبرها. في حال تمرير شرط منطقي <code>predicate</code> كوسيط فستعيد العنصر الأخير الذي يحقق ذلك الشرط.
+
تجلب الدالة <code>lastOrNull()‎</code> آخر عنصر من عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت معها إن لم يُمرَّر إليها أي شيء، أو آخر عنصر يحقق شرطًا معيَّنًا في حال تمرير دالة منطقية إليها.
 
 
 
===<code>[[Kotlin/collections/map|map]]</code>===
 
===<code>[[Kotlin/collections/map|map]]</code>===
تعيد الدالة<code>map()‎</code> لائحة تضم ناتج تطبيق الدالة <code>transform()‎</code> المُمرّرة إليها على عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت عبرها، وفي حال استدعاء الدالة <code>map()‎</code> على قاموس فستعيد لائحة تضم ناتج تطبيق الدالة <code>transform()‎</code> على مداخل (entries) القاموس.
+
تعيد الدالة <code>map()‎</code> قائمةً تحوي ناتج تطبيق الدالة المُمرّرة إليها على كل عنصر من عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] أو الخريطة التي استُدعيت معها.
 
 
 
===<code>[[Kotlin/collections/mapIndexed|mapIndexed]]</code>===
 
===<code>[[Kotlin/collections/mapIndexed|mapIndexed]]</code>===
تعيد الدالة<code>mapIndexed()‎</code> لائحة تضم ناتج تطبيق الدالة <code>transform()‎</code> المُمرّرة إليها على عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت عبرها وعلى فهارسها.
+
تعيد الدالة <code>mapIndexed()‎</code> قائمةً تحوي ناتج تطبيق الدالة المُمرّرة إليها على فهرس وقيمة كل عنصر من عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت معها.
 
+
===<code>[[Kotlin/collections/mapIndexedNotNull|mapIndexedNotNull]]</code>===
 +
تعيد الدالة <code>mapIndexedNotNull()‎</code> قائمةً تحوي ناتج تطبيق الدالة المُمرّرة إليها على فهرس وقيمة كل عنصر من عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت معها باستثناء القيم العدميَّة<code>null</code> التي تعيدها تلك الدالة.
 +
===<code>[[Kotlin/collections/mapIndexedNotNullTo|mapIndexedNotNullTo]]</code>===
 +
تشبه الدالة <code>mapIndexedNotNullTo()‎</code> الدالة <code>[[Kotlin/collections/mapIndexedNotNull|mapIndexedNotNull()‎]]</code> تمامًا باستثناء أنها تضيف الناتج المعاد إلى المعامل الممرَّر إليها.
 
===<code>[[Kotlin/collections/mapIndexedTo|mapIndexedTo]]</code>===
 
===<code>[[Kotlin/collections/mapIndexedTo|mapIndexedTo]]</code>===
تطبق الدالة<code>mapIndexedTo()‎</code> الدالة المُمررّة <code>transform()‎</code> على عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت عبرها وعلى فهارسها وتضيف النتائج إلى المعامل الممرّر <code>destination</code>.
+
تشبه الدالة <code>mapIndexedTo()‎</code> الدالةَ <code>[[Kotlin/collections/mapIndexed|mapIndexed()‎]]</code> في جميع النواحي باستثناء أنها تضيف الناتج المعاد إلى المعامل الممرَّر إليها.
 
+
===<code>[[Kotlin/collections/mapNotNull|mapNotNull]]</code>===
 +
تعيد الدالة <code>mapNotNull()‎</code> قائمةً تحوي ناتج تطبيق الدالة المُمرّرة إليها على كل عنصر من عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] أو الخريطة التي استُدعيت معها باستثناء القيم العدميَّة <code>null</code> التي تعيدها تلك الدالة.
 +
===<code>[[Kotlin/collections/mapNotNullTo|mapNotNullTo]]</code>===
 +
تشبه الدالة <code>mapNotNullTo()‎</code> الدالة <code>[[Kotlin/collections/mapNotNull|mapNotNull()‎]]</code> تمامًا باستثناء أنها تضيف الناتج المعاد إلى المعامل المُمرَّر إليها بدلًا من وضعه في قائمة.
 
===<code>[[Kotlin/collections/mapTo|mapTo]]</code>===
 
===<code>[[Kotlin/collections/mapTo|mapTo]]</code>===
تطبق الدالة<code>mapTo()‎</code> الدالة المُمررّة <code>transform()‎</code> على عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت عبرها وتضيف النتائج إلى المعامل الممرّر<code>destination</code>.  وفي حال استدعاء الدالة <code>mapTo()‎</code> على قاموس فستضيف نتائج تطبيق الدالة<code>transform()‎</code> على مداخل (entries) القاموس إلى المعامل الممرّر <code>destination</code>.
+
تشبه الدالة <code>mapTo()‎</code> الدالة <code>[[Kotlin/collections/map|map()‎]]</code> باستثناء أنَّها تضيف الناتج المعاد إلى المعامل المُمرَّر إليها بدلًا من وضعه في قائمة.
 
 
 
===<code>[[Kotlin/collections/max|max]]</code>===
 
===<code>[[Kotlin/collections/max|max]]</code>===
تعيد الدالة<code>max()‎</code> أكبر عنصر في <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت عبرها، أو <code>null</code> إن كانت فارغة.
+
تجلب الدالة <code>max()‎</code> أكبر عنصر في <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت معها.
 
 
 
===<code>[[Kotlin/collections/maxBy|maxBy]]</code>===
 
===<code>[[Kotlin/collections/maxBy|maxBy]]</code>===
تعيد الدالة<code>maxBy()‎</code> العنصر الأول في <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت عبره والذي له أكبر قيمة معادة من الدالة الممررة <code>selector</code>، أو <code>null</code> إن لم يكن هناك أي عنصر يحقق ذلك.
+
تجلب الدالة <code>maxBy()‎</code> العنصر أو الزوج الأول من <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] أو الخريطة التي استُدعيت معها والذي أعيدت معه أكبر قيمة عند تطبيق دالة معيَّنة عليه.
 
 
 
===<code>[[Kotlin/collections/maxWith|maxWith]]</code>===
 
===<code>[[Kotlin/collections/maxWith|maxWith]]</code>===
تعيد الدالة<code>maxWith()‎</code> العنصر الأول في <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت عبره والذي له أكبر قيمة بحسب المقارِن <code>comparator</code> الممرّر، أو <code>null</code>إن لم يكن هناك أي عنصر يحقق ذلك.
+
تجلب الدالة <code>maxWith()‎</code> العنصر أو الزوج الأول من <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] أو الخريطة التي استُدعيت معها والذي له أكبر قيمة بحسب الموازن <code>comparator</code> المعطى.
 
 
 
===<code>[[Kotlin/collections/min|min]]</code>===
 
===<code>[[Kotlin/collections/min|min]]</code>===
تعيد الدالة<code>min()‎</code> أصغر عنصر في <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت عبرها، أو <code>null</code> إن كانت فارغة.
+
تجلب الدالة <code>min()‎</code> أصغر عنصر في <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت معها.
 
 
 
===<code>[[Kotlin/collections/minBy|minBy]]</code>===
 
===<code>[[Kotlin/collections/minBy|minBy]]</code>===
تعيد الدالة<code>minBy()‎</code> العنصر الأول في <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت عبره والذي له أصغر قيمة معادة من الدالة الممررة <code>selector</code>، أو <code>null</code> إن لم يكن هناك أي عنصر يحقق ذلك.
+
تجلب الدالة <code>minBy()‎</code> العنصر أو الزوج الأول من <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] أو الخريطة التي استُدعيت معها والذي أعيدت معه أصغر قيمة عند تطبيق دالة معيَّنة عليه.
 
 
 
===<code>[[Kotlin/collections/minWith|minWith]]</code>===
 
===<code>[[Kotlin/collections/minWith|minWith]]</code>===
تعيد الدالة<code>minWith()‎</code> العنصر الأول في <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت عبرها والذي له أصغر قيمة بحسب المقارِن <code>comparator</code> الممرّر، أو<code>null</code> إن لم يكن هناك أي عنصر يحقق ذلك.
+
تجلب الدالة <code>minWith()‎</code> العنصر أو الزوج الأول من <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] أو الخريطة التي استُدعيت معها والذي له أصغر قيمة بحسب الموازن <code>comparator</code> المعطى.
 
 
 
===<code>[[Kotlin/collections/none|none]]</code>===
 
===<code>[[Kotlin/collections/none|none]]</code>===
تعيد الدالة<code>none()‎</code> القيمة <code>true</code> إن كانت <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت عبرها فارغة، أو تعيد <code>false</code>. وفي حال تمرير شرط منطقي<code>predicate</code>. فستعيد <code>true</code> إن لم يكن هناك أي عنصر يحقق ذلك الشرط المنطقي، أو تعيد <code>false</code>.
+
تتحقَّق الدالة <code>none()‎</code> إن كانت <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] أو الخريطة التي استدعيت معها فارغةً، أو إن لم يكن هنالك أي عنصر من تلك العناصر محقِّقًا لشرط معين.
 
+
===<code>[[Kotlin/collections/orEmpty|orEmpty]]</code>===
 +
تعيد الدالة <code>orEmpty()‎</code> المصفوفة أو المجموعة أو القائمة أو الخريطة التي استُدعيت معها إن لم تكن مساويةً للقيمة <code>null</code>، أو تعيد كائنًا فارغًا يقابل الكائن المعطى (مصفوفة فارغة، أو مجموعة فارغة ...إلخ.) خلاف ذلك.
 
===<code>[[Kotlin/collections/partition|partition]]</code>===
 
===<code>[[Kotlin/collections/partition|partition]]</code>===
تُقسّم الدالةُ<code>partition()‎</code> <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت عبرها إلى زوج مكوّن من لائحتين، اللائحة الأولى تضم العناصر التي تحقق الشرط المنطقي المُمرّر <code>predicate</code> (أي تعيد <code>true</code>)، بينما تضم الثانية العناصر الأخرى.
+
تقسم الدالة <code>partition()‎</code> <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت معها إلى قسمين؛ الأول يضم العناصر التي تحقِّق شرطًا محدَّدًا، والثاني يضم العناصر الأخرى المتبقيَّة.
 
 
 
===<code>[[Kotlin/collections/plus|plus]]</code>===
 
===<code>[[Kotlin/collections/plus|plus]]</code>===
يختلف سلوك الدالة <code>plus()‎</code> حسب نوع الكائنات التي استُدعيت عبرها ونوع الوسائط الممررة (انظر فقرة <nowiki/>[[Kotlin/collections/plus#.D8.A7.D9.84.D8.A8.D9.86.D9.8A.D8.A9 .D8.A7.D9.84.D8.B9.D8.A7.D9.85.D8.A9|البنية العامة]]).
+
تضيف الدالة <code>plus()‎</code> الوسيط المُمرَّر إليها إلى الكائن الذي استدعيت معه.
 
+
===<code>[[Kotlin/collections/plusElement|plusElement]]</code>===
 +
تضيف الدالة <code>plusElement()‎</code> العنصر المُمرّر إليها إلى <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت معها.
 
===<code>[[Kotlin/collections/reduce|reduce]]</code>===
 
===<code>[[Kotlin/collections/reduce|reduce]]</code>===
يختلف سلوك الدالة<code>reduce()‎</code> حسب نوع الكائنات التي استُدعيت عبرها ونوع المعاملات (parameters) المُمرّرة إليها (انظر فقرة <nowiki/>[[Kotlin/collections/reduce#.D8.A7.D9.84.D8.A8.D9.86.D9.8A.D8.A9 .D8.A7.D9.84.D8.B9.D8.A7.D9.85.D8.A9|البنية العامة]]).
+
تُراكِم الدالة <code>reduce()‎</code> قيمة عنصر بدءًا من العنصر الأول عبر تطبيق عملية معينة من يسار العناصر المعطاة إلى يمينها على القيمة المتراكمة الحالية وعلى العنصر التالي ثم تُعيد قيمة العنصر النهائي الناتج.
 
 
 
===<code>[[Kotlin/collections/reduceIndexed|reduceIndexed]]</code>===
 
===<code>[[Kotlin/collections/reduceIndexed|reduceIndexed]]</code>===
تُراكِم الدالة<code>reduceIndexed()‎</code> القيم بدءًا من العنصر الأول في <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت عبرها وتطبّق العملية <code>operation</code> من اليسار إلى اليمين على القيمة المُتراكمة الراهنة وعلى العنصر الموالي في <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت عبرها وعلى فهرسه. ثم تُعيد القيمة النهائية.
+
تجمع الدالة <code>reduceIndexed()‎</code> ناتج تطبيق عملية معينة على قيمة كل عنصر من عناصر المصفوفة أو المجموعة (بدءًا من اليسار إلى اليمين) المستدعاة معها وفهرس ذلك العنصر بشكل تراكمي والقيمة المجمَّعة الحالية.
 
 
 
===<code>[[Kotlin/collections/reduceRight|reduceRight]]</code>===
 
===<code>[[Kotlin/collections/reduceRight|reduceRight]]</code>===
تُراكِم الدالة<code>reduceRight()‎</code> القيم بدءًا من العنصر الأخير وتطبّق العملية <code>operation</code> من اليمين إلى اليسار على العنصر الموالي في <nowiki/>[[Kotlin/Array|المصفوفة]] أواللائحة التي استُدعيت عبرها وعلى القيمة المُتراكمة الراهنة. ثم تُعيد القيمة النهائية.
+
تجمع الدالة <code>reduceRight()‎</code> بشكل تراكمي ناتج تطبيق عملية معيَّنة على قيمة كل عنصر من عناصر المصفوفة أو المجموعة (بدءًا من اليمين إلى اليسار) المستدعاة معها والقيمة التراكمية الحالية. 
 
 
 
===<code>[[Kotlin/collections/reduceRightIndexed|reduceRightIndexed]]</code>===
 
===<code>[[Kotlin/collections/reduceRightIndexed|reduceRightIndexed]]</code>===
تُراكِم الدالة<code>reduceRightIndexed()‎</code> القيم بدءًا من العنصر الأخير في <nowiki/>[[Kotlin/Array|المصفوفة]] أو اللائحة التي استُدعيت عبرها وتطبّق العملية <code>operation</code> من اليمين إلى اليسار على القيمة المُتراكمة الراهنة وعلى العنصر الموالي في <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت عبرها وعلى فهرسه. ثم تُعيد القيمة النهائية.
+
تجمع الدالة <code>reduceRightIndexed()‎</code> الناتج التراكمي لتطبيق عملية معينة على قيمة كل عنصر من عناصر المصفوفة أو المجموعة (بدءًا من اليمين إلى اليسار) المستدعاة معها وفهرس ذلك العنصر والقيمة المجمَّعة الحالية. 
 
+
===<code>[[Kotlin/collections/requireNoNulls|requireNoNulls]]</code>===
 +
تعيد الدالة <code>requireNoNulls()‎</code> العناصر غير المعدومة (non-null) من <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] أو القائمة التي استُدعيت معها أو ترمي استثناءً إن وجد عنصر معدوم (null).
 
===<code>[[Kotlin/collections/reverse|reverse]]</code>===
 
===<code>[[Kotlin/collections/reverse|reverse]]</code>===
تعكس الدالة<code>reverse()‎</code> ترتيب عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو اللائحة التي استُدعيت عبرها.
+
تعكس الدالة <code>reverse()‎</code> ترتيب عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو القائمة التي استُدعيت معها.
 
 
 
===<code>[[Kotlin/collections/reversed|reversed]]</code>===
 
===<code>[[Kotlin/collections/reversed|reversed]]</code>===
تُعيد الدالة<code>reversed()‎</code> لائحة تضم عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت عبرها بالترتيب المعكوس.
+
تُعيد الدالة <code>reversed()‎</code> قائمة تضم عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت معها بترتيب معكوس.
 
 
 
===<code>[[Kotlin/collections/reversedArray|reversedArray]]</code>===
 
===<code>[[Kotlin/collections/reversedArray|reversedArray]]</code>===
تُعيد الدالة<code>reversedArray()‎</code> <nowiki/>[[Kotlin/Array|مصفوفة]] تضم عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] التي استُدعيت عبرها بالترتيب المعكوس.
+
تعيد الدالة <code>reversedArray()‎</code> <nowiki/>[[Kotlin/Array|مصفوفةً]] تضم عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] التي استُدعيت معها بترتيب معكوس.
 
 
 
===<code>[[Kotlin/collections/single|single]]</code>===
 
===<code>[[Kotlin/collections/single|single]]</code>===
تعيد الدالة<code>single()‎</code>العنصر الوحيد الموجود في <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] أو اللائحة التي استُدعيت عبرها، وفي حال تمرير شرط منطقي <code>predicate</code>كمعامل (parameter) فستعيد العنصر الوحيد الذي يحقق ذلك الشرط المنطقي. أمّا في حال كان الكائن الذي استُدعيت عبره يحتوي أكثر من عنصر واحد (يحقق <code>predicate</code> في حال تمريرها) أو لا يحتوي أي واحد (يحقق <code>predicate</code> في حال تمريرها) فستطلق الدالة  <code>single()‎</code>[[Kotlin/exceptions|استثناءً]].
+
تتحقَّق الدالة <code>single()‎</code> من حواية <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] أو القائمة التي استُدعيت معها عنصرًا واحدًا فقط أو عنصرًا واحدًا محققًا لشرط معيَّن ثمَّ تعيده أو تطلق <nowiki/>[[Kotlin/exceptions|استثناءً]] خلاف ذلك.
 
 
 
===<code>[[Kotlin/collections/singleOrNull|singleOrNull]]</code>===
 
===<code>[[Kotlin/collections/singleOrNull|singleOrNull]]</code>===
تعيد الدالة<code>singleOrNull()‎</code>العنصر الوحيد الموجود في <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] أو اللائحة التي استُدعيت عبرها، وفي حال تمرير شرط منطقي<code>predicate</code> كمعامل (parameter) فستعيد العنصر الوحيد الذي يحقق ذلك الشرط المنطقي. أمّا في حال كان الكائن الذي استُدعيت عبره يحتوي أكثر من عنصر واحد (يحقق <code>predicate</code> في حال تمريرها) أو لا يحتوي أي واحد (يحقق <code>predicate</code> في حال تمريرها) فستعيد القيمة المعدومة <code>null</code>.
+
تتحقَّق الدالة <code>singleOrNull()‎</code> من حواية <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] أو القائمة التي استُدعيت معها عنصرًا واحدًا فقط، أو عنصرًا واحدًا محققًا لشرط معيَّن ثمَّ تعيده، أو تعيد القيمة <code>null</code>خلاف ذلك.
 
 
 
===<code>[[Kotlin/collections/slice|slice]]</code>===
 
===<code>[[Kotlin/collections/slice|slice]]</code>===
تعيد الدالة<code>slice()‎</code>لائحة تحتوي عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو اللائحة التي استُدعيت عبرها والموجودة عند الفهارس التي يحددها الوسيط الممرّر <code>indices</code>.
+
تقطع الدالة <code>slice()‎</code> جزءًا محدَّدًا من <nowiki/>[[Kotlin/Array|المصفوفة]] أو القائمة التي استُدعيت معها ثمَّ تعيده في قائمة.
 
 
 
===<code>[[Kotlin/collections/sliceArray|sliceArray]]</code>===
 
===<code>[[Kotlin/collections/sliceArray|sliceArray]]</code>===
تعيد الدالة<code>sliceArray()‎</code>لائحة أو <nowiki/>[[Kotlin/Array|مصفوفة]] تحتوي عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] التي استُدعيت عبرها والموجودة عند الفهارس التي يحددها الوسيط الممرّر<code>indices</code>.
+
تقطع الدالة <code>sliceArray()‎</code> جزءًا محدَّدًا من <nowiki/>[[Kotlin/Array|المصفوفة]] التي استُدعيت معها ثمَّ تعيده في مصفوفة أو قائمة بحسب الوسيط الممرر إليها. 
 
 
 
===<code>[[Kotlin/collections/sort|sort]]</code>===
 
===<code>[[Kotlin/collections/sort|sort]]</code>===
تقوم الدالة<code>sort()‎</code> بترتيب <nowiki/>[[Kotlin/Array|المصفوفة]] أو اللائحة المتغيرة (<code>MutableList</code>) التي استُدعيت عبرها.
+
ترتِّب الدالة <code>sort()‎</code> <nowiki/>[[Kotlin/Array|المصفوفة]] أو القائمة المتغيرة (MutableList) التي استُدعيت معها تصاعديًّا.
 
+
===<code>[[Kotlin/collections/sortBy|sortBy]]</code>===
 +
ترتِّب الدالة <code>sortBy()‎</code> عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو القائمة المتغيرة (MutableList) التي استُدعيت معها تصاعديًّا وفقًا للقيم التي تعيدها الدالة المُمرّرة إليها عند تطبيقها على كل عنصر.
 +
===<code>[[Kotlin/collections/sortByDescending|sortByDescending]]</code>===
 +
ترتِّب الدالة <code>sortByDescending()‎</code> عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو القائمة المتغيرة (MutableList) التي استُدعيت معها تنازليًّا وفقًا للقيم التي تعيدها الدالة المُمرّرة إليها عند تطبيقها على كل عنصر. 
 
===<code>[[Kotlin/collections/sortDescending|sortDescending]]</code>===
 
===<code>[[Kotlin/collections/sortDescending|sortDescending]]</code>===
تقوم الدالة<code>sortDescending()‎</code> بترتيب <nowiki/>[[Kotlin/Array|المصفوفة]] أو اللائحة المتغيرة (<code>MutableList</code>) التي استُدعيت عبرها تنازليًا.
+
ترتِّب الدالة <code>sortDescending()‎</code> <nowiki/>[[Kotlin/Array|المصفوفة]] أو القائمة المتغيرة (MutableList) التي استُدعيت معها تنازليًّا. 
 
+
===<code>[[Kotlin/collections/sortWith|sortWith]]</code>===
 +
ترتِّب الدالة <code>sortWith()‎</code> جميع عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو القائمة المتغيرة (MutableList) التي استُدعيت معها أو جزءًا محدَّدًا منها تنازليًا وفقًا للمُقارن المُمرّر إليها.
 
===<code>[[Kotlin/collections/sorted|sorted]]</code>===
 
===<code>[[Kotlin/collections/sorted|sorted]]</code>===
تعيد الدالة<code>sorted()‎</code> لائحة تضم عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو المجموعة التكرارية التي استُدعيت عبرها مرتبة وفق الترتيب الطبيعي.
+
ترتِّب الدالة <code>sorted()‎</code> جميع عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو المجموعة التكرارية التي استُدعيت معها تصاعديًّا ثمَّ تضع الناتج في قائمة.
 
 
 
===<code>[[Kotlin/collections/sortedArray|sortedArray]]</code>===
 
===<code>[[Kotlin/collections/sortedArray|sortedArray]]</code>===
تعيد الدالة<code>sortedArray()‎</code> <nowiki/>[[Kotlin/Array|مصفوفة]] تضم عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] التي استُدعيت عبرها مرتبة وفق الترتيب الطبيعي.
+
ترتِّب الدالة <code>sortedArray()‎</code> جميع عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] التي استُدعيت معها تصاعديًّا ثمَّ تضع الناتج في مصفوفة جديدة. 
 
 
 
===<code>[[Kotlin/collections/sortedArrayDescending|sortedArrayDescending]]</code>===
 
===<code>[[Kotlin/collections/sortedArrayDescending|sortedArrayDescending]]</code>===
تعيد الدالة<code>sortedArrayDescending()‎</code> <nowiki/>[[Kotlin/Array|مصفوفة]] تضم عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] التي استُدعيت عبرها مرتبة ترتيبًا تنازليًا.
+
ترتِّب الدالة <code>sortedArrayDescending()‎</code> جميع عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] التي استُدعيت معها تنازليًّا ثمَّ تضع الناتج في <nowiki/>[[Kotlin/Array|مصفوفة]] جديدة. 
 
+
===<code>[[Kotlin/collections/sortedArrayWith|sortedArrayWith]]</code>===
 +
ترتِّب الدالة <code>sortedArrayWith()‎</code> جميع عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] التي استُدعيت معها وفقًا للمُقارِن المُمرّر إليها ثمَّ تضع الناتج في مصفوفة جديدة. 
 
===<code>[[Kotlin/collections/sortedBy|sortedBy]]</code>===
 
===<code>[[Kotlin/collections/sortedBy|sortedBy]]</code>===
تعيد الدالة<code>sortedBy()‎</code> لائحة تضم عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو اللائحة المتغيرة (<code>MutableList</code>) التي استُدعيت عبرها مرتبة وفقًا للقيم التي تعيدها الدالة المُمرّرة <code>selector</code>.
+
ترتِّب الدالة <code>sortedBy()‎</code> جميع عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو المجموعة التكرارية (Iterable) التي استُدعيت معها تصاعديًّا وفقًا للقيم التي تعيدها الدالة المُمرّرة إليها عند تطبيقها على كل عنصر ثمَّ تضع الناتج في قائمة.
 
 
 
===<code>[[Kotlin/collections/sortedByDescending|sortedByDescending]]</code>===
 
===<code>[[Kotlin/collections/sortedByDescending|sortedByDescending]]</code>===
تعيد الدالة<code>sortedByDescending()‎</code> لائحة تضم عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو اللائحة المتغيرة (<code>MutableList</code>) التي استُدعيت عبرها مرتبة ترتيبًا تنازليًا وفقًا للقيم التي تعيدها الدالة المُمرّرة <code>selector</code>.
+
ترتِّب الدالة <code>sortedByDescending()‎</code> جميع عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو المجموعة التكرارية (Iterable) التي استُدعيت معها تنازليًّا وفقًا للقيم التي تعيدها الدالة المُمرّرة إليها عند تطبيقها على كل عنصر ثمَّ تضع الناتج في قائمة.
 
 
 
===<code>[[Kotlin/collections/sortedDescending|sortedDescending]]</code>===
 
===<code>[[Kotlin/collections/sortedDescending|sortedDescending]]</code>===
تعيد الدالة<code>sortedDescending()‎</code> لائحة تضم عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو المجموعة التكرارية التي استُدعيت عبرها مرتبة تنازليًا.
+
ترتِّب الدالة <code>sortedDescending()‎</code> جميع عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو المجموعة التكرارية التي استُدعيت معها تنازليًّا ثمَّ تضع الناتج في قائمة.
 
 
 
===<code>[[Kotlin/collections/sortedWith|sortedWith]]</code>===
 
===<code>[[Kotlin/collections/sortedWith|sortedWith]]</code>===
تعيد الدالة<code>sortedWith()‎</code> لائحة تضم عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو المجموعة التكرارية التي استُدعيت عبرها مرتبة وفق المُقارِن المُمرّر <code>comparator</code>.
+
ترتِّب الدالة <code>sortedWith()‎</code> جميع عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو المجموعة التكرارية التي استُدعيت معها وفقًا للمُقارِن المُمرّر إليها ثمَّ تضع الناتج في قائمة.
 
 
 
===<code>[[Kotlin/collections/subtract|subtract]]</code>===
 
===<code>[[Kotlin/collections/subtract|subtract]]</code>===
تعيد الدالة<code>subtract()‎</code> مجموعة (<code>Set</code>) تضم عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو المجموعة التكرارية التي استُدعيت عبرها والتي لا توجد في <nowiki/>[[Kotlin/collections|المجموعة]] المُمرّرة.
+
تستثني الدالة <code>subtract()‎</code> العناصر المشتركة بين كائنين.
 
 
 
===<code>[[Kotlin/collections/sum|sum]]</code>===
 
===<code>[[Kotlin/collections/sum|sum]]</code>===
تعيد الدالة<code>sum()‎</code> مجموع عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت عبرها.
+
تجمع الدالة <code>sum()‎</code> جميع قيم عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت معها ثمَّ تعيد الناتج.
 
 
 
===<code>[[Kotlin/collections/sumBy|sumBy]]</code>===
 
===<code>[[Kotlin/collections/sumBy|sumBy]]</code>===
تعيد الدالة<code>sumBy()‎</code> مجموع العناصر المُعادة من الدالة <code>selector</code> مطبقةً على عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت عبرها.
+
تجمع الدالة <code>sumBy()‎</code> جميع نواتج تطبيق دالة معيَّنة على كل عنصر من عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت معها.
 
 
 
===<code>[[Kotlin/collections/sumByDouble|sumByDouble]]</code>===
 
===<code>[[Kotlin/collections/sumByDouble|sumByDouble]]</code>===
تعيد الدالة<code>sumByDouble()‎</code> مجموع العناصر المُعادة من الدالة <code>selector</code> مطبقةً على عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت عبرها.
+
تجمع الدالة <code>sumByDouble()‎</code> جميع نواتج تطبيق دالة معيَّنة على كل عنصر من عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت معها.
 
 
 
===<code>[[Kotlin/collections/take|take]]</code>===
 
===<code>[[Kotlin/collections/take|take]]</code>===
تعيد الدالة<code>take()‎</code> لائحة تضم <code>n</code> من أولى العناصر الموجودة في <nowiki/>[[Kotlin/Array|المصفوفة]] أو المجموعة التكرارية التي استُدعيت عبرها.
+
تجلب الدالة <code>take()‎</code> أول <code>n</code> عنصر من <nowiki/>[[Kotlin/Array|المصفوفة]] أو المجموعة التكرارية التي استُدعيت معها وتضعها في قائمة.
 
 
 
===<code>[[Kotlin/collections/takeLast|takeLast]]</code>===
 
===<code>[[Kotlin/collections/takeLast|takeLast]]</code>===
تعيد الدالة<code>takeLast()‎</code> لائحة تضم آخر <code>n</code> من العناصر الموجودة في <nowiki/>[[Kotlin/Array|المصفوفة]] أو المجموعة التكرارية التي استُدعيت عبرها.
+
تجلب الدالة <code>takeLast()‎</code> آخر <code>n</code> عنصر من <nowiki/>[[Kotlin/Array|المصفوفة]] أو المجموعة التكرارية التي استُدعيت معها وتضعها في قائمة. 
 
 
 
===<code>[[Kotlin/collections/takeLastWhile|takeLastWhile]]</code>===
 
===<code>[[Kotlin/collections/takeLastWhile|takeLastWhile]]</code>===
تعيد الدالة<code>takeLastWhile()‎</code> لائحة تضم آخر عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو اللائحة التي استُدعيت عبرها والتي تحقق الشرط المنطقي المُمرّر <code>predicate</code>.
+
تجلب الدالة <code>takeLastWhile()‎</code> آخر عناصر محققة لشرطٍ محدَّدٍ من <nowiki/>[[Kotlin/Array|المصفوفة]] أو القائمة التي استُدعيت معها.
 
 
 
===<code>[[Kotlin/collections/takeWhile|takeWhile]]</code>===
 
===<code>[[Kotlin/collections/takeWhile|takeWhile]]</code>===
تعيد الدالة<code>takeWhile()‎</code> لائحة تضم أولى عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو المجموعة التكرارية التي استُدعيت عبرها والتي تحقق الشرط المنطقي المُمرّر<code>predicate</code>.
+
تجلب الدالة <code>takeWhile()‎</code> أول عناصر محققة لشرطٍ محدَّدٍ من <nowiki/>[[Kotlin/Array|المصفوفة]] أو القائمة التي استُدعيت معها. 
 
+
===<code>[[Kotlin/collections/toBooleanArray|toBooleanArray]]</code>===
 +
تحول الدالة <code>toBooleanArray()‎</code> <nowiki/>[[Kotlin/Array|المصفوفة العامة]] (أي من النوع <code>Array<out Boolean>‎</code>) أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت معها إلى <nowiki/>[[Kotlin/Array|مصفوفة]] من قيم منطقية (أي من النوع<code>BooleanArray</code>) .
 +
===<code>[[Kotlin/collections/toByteArray|toByteArray]]</code>===
 +
تحوِّل الدالة <code>toByteArray()‎</code> <nowiki/>[[Kotlin/Array|المصفوفة العامة]] (أي من النوع <code>Array<Byte>‎</code>) أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت معها إلى <nowiki/>[[Kotlin/Array|مصفوفة]] من النوع <code>[[Kotlin/ByteArray/index|ByteArray]]</code>.
 +
===<code>[[Kotlin/collections/toCharArray|toCharArray]]</code>===
 +
تحول الدالة <code>toCharArray()‎</code> <nowiki/>[[Kotlin/Array|المصفوفة العامة]] (أي التي من النوع <code>Array<Char>‎</code>) أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت معها إلى <nowiki/>[[Kotlin/Array|مصفوفة]] من النوع <code>[[Kotlin/CharArray/index|CharArray]]</code>.
 
===<code>[[Kotlin/collections/toCollection|toCollection]]</code>===
 
===<code>[[Kotlin/collections/toCollection|toCollection]]</code>===
تضيف الدالة<code>toCollection()‎</code> عناصر <nowiki/>[[Kotlin/Array|المصفوفة]]  أو <nowiki/>[[Kotlin/collections|المجموعة]]  التي استُدعيت عبرها إلى المجموعة المتغيرة (<code>MutableCollection</code>) المُمرّرة<code>destination</code>.
+
تضيف الدالة <code>toCollection()‎</code> جميع عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت معها إلى المجموعة المتغيرة (MutableCollection) المُمرّرة إليها.
 
+
===<code>[[Kotlin/collections/toDoubleArray|toDoubleArray]]</code>===
 +
تحول الدالة <code>toDoubleArray()‎</code> <nowiki/>[[Kotlin/Array|المصفوفة العامة]] (أي من النوع <code>Array<Double>‎</code>) أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت معها إلى <nowiki/>[[Kotlin/Array|مصفوفة]] من النوع <code>[[Kotlin/DoubleArray/index|DoubleArray]]</code>.
 +
===<code>[[Kotlin/collections/toFloatArray|toFloatArray]]</code>===
 +
تحول الدالة <code>toFloatArray()‎</code> <nowiki/>[[Kotlin/Array|المصفوفة العامة]] (أي من النوع <code>Array<Float>‎</code>) أو <nowiki/>[[Kotlin/collections|المجموعة]]  التي استُدعيت معها <nowiki/>[[Kotlin/Array|مصفوفة]] من النوع <code>[[Kotlin/FloatArray/index|FloatArray]]</code>.
 
===<code>[[Kotlin/collections/toHashSet|toHashSet]]</code>===
 
===<code>[[Kotlin/collections/toHashSet|toHashSet]]</code>===
تعيد الدالة<code>toHashSet()‎</code> كائنًا من النوع <code>HashSet</code>يضم جميع عناصر <nowiki/>[[Kotlin/Array|المصفوفة]]  أو <nowiki/>[[Kotlin/collections|المجموعة]]  التي استُدعيت عبرها.
+
تعيد الدالة <code>toHashSet()‎</code> كائنًا من النوع <code>HashSet</code> لجميع عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت معها.
 
+
===<code>[[Kotlin/collections/toIntArray|toIntArray]]</code>===
 +
تحول الدالة <code>toIntArray()‎</code> <nowiki/>[[Kotlin/Array|المصفوفة العامة]] (أي من النوع <code>Array<Int>‎</code>) أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت معها إلى <nowiki/>[[Kotlin/Array|مصفوفة]] من النوع <code>IntArray</code>.
 
===<code>[[Kotlin/collections/toList|toList]]</code>===
 
===<code>[[Kotlin/collections/toList|toList]]</code>===
تعيد الدالة<code>toList()‎</code> لائحة تضم جميع عناصر <nowiki/>[[Kotlin/Array|المصفوفة]]  أو المجموعة التكرارية  التي استُدعيت عبرها. وفي حال استدعاء الدالة<code>toList()‎</code> عبر قاموسفستعيد لائحة تضم جميع الأزواج مفتاح/قيمة المنتمية إليه.
+
تحول الدالة <code>toList()‎</code> <nowiki/>[[Kotlin/Array|المصفوفة]] أو المجموعة التكرارية أو الخريطة التي استُدعيت معها إلى قائمة.
 
+
===<code>[[Kotlin/collections/toLongArray|toLongArray]]</code>===
 +
تحول الدالة <code>toList()‎</code> <nowiki/>[[Kotlin/Array|المصفوفة]] أو المجموعة التكرارية أو الخريطة التي استُدعيت معها إلى قائمة.
 +
===<code>[[Kotlin/collections/toMap|toMap]]</code>===
 +
تحول الدالة <code>toLongArray()‎</code> <nowiki/>[[Kotlin/Array|المصفوفة العامة]] (أي من النوع <code>Array<Long>‎</code>) أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت معها إلى <nowiki/>[[Kotlin/Array|مصفوفة]] من النوع <code>LongArray</code>.
 
===<code>[[Kotlin/collections/toMutableList|toMutableList]]</code>===
 
===<code>[[Kotlin/collections/toMutableList|toMutableList]]</code>===
تعيد الدالة<code>toMutableList()‎</code> لائحة متغيرة تضم جميع عناصر <nowiki/>[[Kotlin/Array|المصفوف]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت عبرها.
+
تحول الدالة <code>toMutableList()‎</code> <nowiki/>[[Kotlin/Array|المصفوف]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت معها إلى قائمة متغيرة.
 
 
 
===<code>[[Kotlin/collections/toMutableSet|toMutableSet]]</code>===
 
===<code>[[Kotlin/collections/toMutableSet|toMutableSet]]</code>===
تعيد الدالة<code>toMutableSet()‎</code> مجموعة من النوع <code>MutableSet</code> تضم جميع عناصر <nowiki/>[[Kotlin/Array|المصفوفة]]  أو المجموعة التكرارية  التي استُدعيت عبرها بدون تكرار.
+
تحول الدالة <code>toMutableSet()‎</code> <nowiki/>[[Kotlin/Array|المصفوفة]] أو المجموعة التكرارية التي استُدعيت معها إلى مجموعة من النوع <code>MutableSet</code>؛ تحافظ المجموعة المُعادة على نفس ترتيب تكرار المصفوفة أو المجموعة التكرارية الأصلية.
 
 
 
===<code>[[Kotlin/collections/toSet|toSet]]</code>===
 
===<code>[[Kotlin/collections/toSet|toSet]]</code>===
تعيد الدالة<code>toSet()‎</code>  مجموعة من النوع <code>Set</code> تضم جميع عناصر <nowiki/>[[Kotlin/Array|المصفوفة]]  أو المجموعة التكرارية  التي استُدعيت عبرها.
+
تحول الدالة <code>toSet()‎</code> <nowiki/>[[Kotlin/Array|المصفوفة]] أو المجموعة التكرارية التي استُدعيت معها إلى مجموعة من النوع <code>Set</code>. تحافظ المجموعة المُعادة على نفس ترتيب تكرار المصفوفة أو المجموعة التكرارية الأصلية. 
 
+
===<code>[[Kotlin/collections/toShortArray|toShortArray]]</code>===
 +
تحول الدالة <code>toShortArray()‎</code> <nowiki/>[[Kotlin/Array|المصفوفة العامة]] (أي من النوع <code>Array<Short>‎</code>) أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت معها إلى <nowiki/>[[Kotlin/Array|مصفوفة]] من النوع <code>ShortArray</code>.
 
===<code>[[Kotlin/collections/toSortedSet|toSortedSet]]</code>===
 
===<code>[[Kotlin/collections/toSortedSet|toSortedSet]]</code>===
تعيد الدالة<code>toSortedSet()‎</code> مجموعة من النوع <code>SortedSet</code> تضم جميع عناصر <nowiki/>[[Kotlin/Array|المصفوفة]]  أو المجموعة التكرارية  التي استُدعيت عبرها. وفي حال تمرير دالة مقارنة <code>comparator</code> إلى الدالة<code>toSortedSet()‎</code> فسترتب المجموعة المعادة حسب ذلك المقارِن
+
تحول الدالة <code>toSortedSet()‎</code> <nowiki/>[[Kotlin/Array|المصفوفة]] أو المجموعة التكرارية التي استُدعيت معها إلى مجموعة من النوع <code>SortedSet</code> ثمَّ تعيدها فقط إن لم يمرَّر إليها أي شيء، أو ترتِّبها وفقًا لترتيب معيَّن ثمَّ تعيدها إن مرِّرت إليها دالة مقارنة.
 
 
 
===<code>[[Kotlin/collections/union|union]]</code>===
 
===<code>[[Kotlin/collections/union|union]]</code>===
تعيد الدالة<code>union()‎</code> مجموعة من النوع Set تضم جميع عناصر <nowiki/>[[Kotlin/Array|المصفوفة]]  أو المجموعة التكرارية  التي استُدعيت عبرها والمجموعة التكرارية المُمرّرة.
+
تجمع الدالة <code>union()‎</code> العناصر المشتركة وغير المتشركة بين <nowiki/>[[Kotlin/Array|المصفوفة]] أو المجموعة التكرارية التي استُدعيت معها وبين المجموعة التكرارية المُمرّرة إليها في مجموعةٍ واحدةٍ من النوع <code>Set</code> بعد حذف العناصر المتكررة.
 
+
===<code>[[Kotlin/collections/unzip|unzip]]</code>===
 +
تعيد الدالة <code>unzip()‎</code> قائمتين، إذ تحتوي الأولى على القيم الأولى لكل زوج من أزواج <nowiki/>[[Kotlin/Array|المصفوفة]] أو المجموعة التكرارية التي استُدعيت معها وتحتوي الثانية على القيم الثانية لكل زوج من تلك الأزواج.
 
===<code>[[Kotlin/collections/withIndex|withIndex]]</code>===
 
===<code>[[Kotlin/collections/withIndex|withIndex]]</code>===
تعيد الدالة<code>withIndex()‎</code> مجموعة تكرارية خاملة (lazy Iterable) من القيم المُفهرسة لكل عنصر من عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو المجموعة التكرارية  التي استُدعيت عبرها، وفي حال استدعائها عبر <nowiki/>[[Kotlin/iterator|مُكرّر]] (<code>Iterator</code>) فستعيد <nowiki/>[[Kotlin/iterator|مُكرّر]]<nowiki/>ا يغلّف كل عنصر مُنتج من ذلك <nowiki/>[[Kotlin/iterator|المكرّر]] مع القيمة المُفهرسة.
+
تعيد الدالة <code>withIndex()‎</code> مجموعة تكرارية خاملة (lazy Iterable) من القيم المُفهرسة لكل عنصر من عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو المجموعة التكرارية التي استُدعيت معها، أو تعيد <nowiki/>[[Kotlin/iterator|مُكرّرًا]] (iterator) يغلّف كل عنصر أنتجه <nowiki/>[[Kotlin/iterator|المكرّر]] (Iterator) المستدعى مع الدالة مع القيمة المُفهرسة أي يعيد القيمة مع فهرسها.
 +
===<code>[[Kotlin/collections/zip|zip]]</code>===
 +
تنشئ الدالة <code>zip()‎</code> أزواجًا من عناصر كائنين لها نفس الفهرس، أو تنشئ قيمًا عبر تمرير عناصر لها نفس الفهرس تجلب من كائنين مختلفين إلى دالة معينة.
  
===<code>[[Kotlin/collections/zip|zip]]</code>===
+
== مصادر ==
يختلف سلوك الدالة<code>zip()‎</code> بحسب إمضائها، أنظر فقرة <nowiki/>[[Kotlin/collections/zip#.D8.A7.D9.84.D8.A8.D9.86.D9.8A.D8.A9 .D8.A7.D9.84.D8.B9.D8.A7.D9.85.D8.A9|البنية العامة]] لأجل التفاصيل.
+
* [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-byte-array/index.html صفحة الصنف ByteArray في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 
[[تصنيف:Kotlin]]
 
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin Classes]]
+
[[تصنيف:Kotlin Class]]
 
[[تصنيف:Kotlin ByteArray]]
 
[[تصنيف:Kotlin ByteArray]]

المراجعة الحالية بتاريخ 06:38، 9 سبتمبر 2018

يمثل الصنف ByteArray مصفوفةً من البايتات. إن كانت منصة التشغيل المستهدفة هي JVM، فيمكن تمثيل نُسَخ هذا الصنف بالشكل []byte.

class ByteArray

الدوال البانية

<int>

تنشئ الدالة ByteArray()‎ البانية مصفوفة جديدة من النوع ByteArray (أي حجم كل عنصر منها بايتًا واحدًا) بحجم معين، إذ تحوي قيمًا محدَّدة أو القيم 0.

الخاصيات

size

تمثِّل الخاصيّة size عدد العناصر الموجودة في المصفوفة ذات النوع ByteArray.

الدوال

get

يجلب التابع get()‎ عنصرًا ذي فهرس محدد من المصفوفة.

iterator

ينشئ التابع iterator()‎ عنصرًا تكراريًّا (iterator) لتكرار بنيةٍ (block) برمجيةٍ على كافّة عناصر المصفوفة المستدعاة معه.

set

يضبط التابع set()‎ قيمة عنصر ذي فهرس محدد موجود في المصفوفة المستدعاة معه.

 الدوال الموروثة

equals

تحدد الدالة equals()‎ إذا ما كان الكائن المُمرّر إليها يساوي الكائن الذي استدعيت معها.

hashCode

تعيد الدالة hashCode()‎ قيمة الشيفرة Hash الخاصّة بالكائن الذي استُدعي معها.

toString

تحول الدالة toString()‎ الكائن الذي يُستدعى معها إلى سلسلة نصية.

الخاصيات الإضافية (Extension Properties)

indices

تُستخدَم هذه الخاصيّة للحصول على الفهارس الصحيحة (valid indices) للمصفوفة أو المجموعة (collection).

lastIndex

تُستخدَم هذه الخاصيّة لجلب الفهرس (index) الأخير لمصفوفة أو قائمة (list).

الدوال الإضافية (Extension Functions)

all

تتحقق الدالة all()‎ إن كانت كافّة عناصر المصفوفة أو المجموعة (collection) التي استُدعيت عبرها تطابق شرطًا منطقيًّا محدَّدًا.

any

يختلف سلوك الدالة any()‎ بحسب طريقة استدعائها، وسنناقش هذه الحالات تباعًا.

asIterable

تُنشِئ الدالة asIterable()‎نسخةً تكراريّةً (iterable instance) تُغلّف (wrap) المصفوفة الأصلية وتعيد عناصرَها عندما تُستخدَم في حلقات التكرار (مثل for).

asList

تُعيد الدالة asList()‎ قائمةً (list) تُغلّف المصفوفة الأصلية التي استُدعيت عبرها.

asSequence

تُنشِئ الدالة asSequence()‎ نسخةً (instance) من النوع sequence والتي تُغلّف المصفوفة الأصلية وتعيد عناصرها عندما تُستخدَم في حلقات التكرار (مثل حلقة for).

associate

تعيد الدالة associate()‎ خريطةً (map) تحوي أزواجًا من "مفتاح/قيمة" ناتجة عن تمرير عناصر المصفوفة أو المجموعة (Collection) إلى الدالة المررة إليها.

associateBy

تعيد الدالة associateBy()‎ خريطةً (map) مكونة من الأزواج "مفتاح/قيمة"، إذ يكون المفتاح (key) هو الناتج الذي تعيده الدالة keySelector الممررة إليها وتكون القيمة (value) المقابلة لذلك المفتاح هي إمَّا عناصر المصفوفة أو المجموعة المعطاة أو الناتج الذي تعيده الدالة valueTransform الممررة.

associateByTo

تشبه الدالة associateByTo()‎ الدالة associateBy()‎ تمامًا باستثناء أنها تضيف الناتج الذي تعيده إلى خريطة موجودة مسبقًا. 

associateTo

تشبه الدالة associateTo()‎ الدالة associate()‎ تمامًا باستثناء أنها تضيف الناتج الذي تعيده إلى خريطة موجودة مسبقًا.  

average

تحسب الدالة average()‎ متوسط (average) عناصر المصفوفة أو المجموعة (Collection) المعطاة لها.

binarySearch

تبحث الدالة binarySearch()‎ عن عنصر معين في المجموعة أو مجال من المجموعة (Collection) باستخدام خوارزميَّة البحث الثنائي (binary search algorithm) وتعيد فهرس موقعه. ويجب أن تكون المجموعة مرتبَّةً وفق المُقارِن comparator وإلا فستكون النتيجة المعادة غير مُحدّدة.

component1

تعيد الدالة component1()‎ العنصر الأول من المصفوفة أو المفتاح (key) لأول زوج (مفتاح/قيمة) في الخريطة (map) التي استدعيت معها. تسمح هذه الدالة باستخدام التصريحات التفكيكية (destructuring declarations) عند العمل على الخرائط. 

contains

تتحقق الدالة contains()‎ إن كانت المصفوفة أو المجموعة التي استُدعيت معها تحتوي على العنصر الممرّر إليها، أو إن كانت الخريطة التي استدعيت معها تحتوي على ذلك العنصر كمفتاح (key).

contentDeepEquals

تتحقق الدالة contentDeepEquals()‎ من تساوي مصفوفتين بالعُمق، أي أنهما تحتويان على نفس العناصر وبنفس الترتيب.

contentDeepHashCode

تشِّفر الدالة contentDeepHashCode()‎ محتوى المصفوفة التي استُدعيت معها كما لو كانت قائمة إلى شيفرة Hash. تعامل المصفوفات المُتشعبة مثل القوائم أيضًا.

contentDeepToString

تعيد الدالة contentDeepToString()‎ سلسلة نصية تمثِّل محتوى المصفوفة التي استُدعيت معها كما لو كانت قائمة. تعامل المصفوفات المُتشعبة مثل معاملة القوائم أيضًا.

contentEquals

تتحقَّق الدالة contentEquals()‎ من تساوي مصفوفتين بنيويًا (structurally equal)، أي إن كان لهما نفس العناصر وبنفس العدد والترتيب.

contentHashCode

تشفِّر الدالة contentHashCode()‎ محتوى المصفوفة التي استُدعيت معها كما لو كانت قائمة إلى شيفرة Hash.

contentToString

تعيد الدالة contentToString()‎ سلسلة نصية تمثِّل محتوى المصفوفة التي استُدعيت معها كما لو كانت قائمة.

copyOf

تنسخ الدالة copyOf()‎ كامل المصفوفة التي استُدعيت معها أو جزءًا منها.  

copyOfRange

تنسخ الدالة copyOfRange()‎ مجالًا محدَّدًا من المصفوفة التي استُدعيت معها.

count

تعيد الدالة count()‎ عدد جميع عناصر المصفوفة أو المجموعة أو الخريطة التي استُدعيت معها أو العناصر التي تحقق شرطًا معينًا.

distinct

تحذف الدالة distinct()‎ العناصر المتكررة الموجودة في المصفوفة أو المجموعة التي استُدعيت معها وتعيد الناتج في قائمة.

distinctBy

تعيد الدالة distinctBy()‎ قائمة تحتوي على العناصر الموجودة في المصفوفة أو المجموعة التي استُدعيت معها والتي تعطي نتيجة مختلفة عند تطبيق الدالة selector عليها فقط. 

drop

تعيد الدالة drop()‎ قائمة تحوي جميع عناصر المصفوفة أو المجموعة التي استُدعيت معها باستثناء أول n عنصر.

dropLast

تعيد الدالة dropLast()‎ قائمة تحوي جميع عناصر المصفوفة أو المجموعة التي استُدعيت معها باستثناء آخر n عنصر.

dropLastWhile

تعيد الدالة dropLastWhile()‎ قائمةً تحوي جميع عناصر المصفوفة أو المجموعة التي استُدعيت معها باستثناء العناصر الأخيرة التي تحقق شرطًا معيَّنًا.

تحتوي جميع عناصر المصفوفة أو المجموعة التي استُدعيت عبرها باستثناء العناصر الأخيرة التي تحقق الشرط المنطقي predicate المُمرّر إلى الدالة.

dropWhile

تعيد الدالة dropWhile()‎ قائمةً تحوي جميع عناصر المصفوفة أو المجموعة التي استُدعيت معها باستثناء العناصر الأولى التي تحقق شرطًا معيَّنًا.

elementAt

تجلب الدالة elementAt()‎ عنصرًا ذي فهرس معيَّن من المصفوفة أو المجموعة التي استُدعيت معها. 

elementAtOrElse

تجلب الدالة elementAtOrElse()‎ عنصرًا ذي فهرس معيَّن من المصفوفة أو المجموعة التي استُدعيت معها. إن كان الفهرس المعطى خارج حدود المصفوفة أو المجموعة، فستُعيد الدالة ناتج استدعاء دالة معينة.

elementAtOrNull

تعيد الدالةelementAtOrNull()‎ العنصر الموجود عند الفهرس (index) المحدد من المصفوفة أو المجموعة التي استُدعيت عبرها، وفي حال كان ذلك الفهرس خارج حدود المصفوفة أو المجموعة فستُعيد القيمة المعدومة null.

fill

تبدِّل الدالة fill()‎ قيمة جديدة معطاة مكان عناصر محدَّدة في المصفوفة أو القائمة التي تستدعى معها.

filter

ترشِّح الدالة filter()‎ عناصر المصفوفة أو المجموعة أو أزواج الخرائط المعطاة التي تحقِّق شرطًا معيَّنًا ثمّ تعيدها.

filterIndexed

ترشِّح الدالة filterIndexed()‎ عناصر المصفوفة أو المجموعة المعطاة بناءً على فهرس العنصر وقيمته.

filterIndexedTo

تشبه الدالة filterIndexedTo()‎ الدالة filterIndexed() تمامًا باستثناء أنها تضيف الناتج إلى كائن موجود مسبقًا بدلًا من أن تعيده.  

filterIsInstance

تعيد الدالة filterIsInstance()‎ قائمة تحوي عناصر المصفوفة أو المجموعة المعطاة التي هي نسخةٌ (instance) من نوع أو صنفٍ معيّن.

filterIsInstanceTo

تضيف الدالة filterIsInstanceTo()‎ عناصر المصفوفة أو المجموعة المعطاة التي هي نسخةٌ (instance) من نوع أو صنفٍ معيّن إلى المجموعة المتغيرة destination المُمرّرة إليها.

filterNot

تعيد الدالة filterNot()‎ قائمةً تحوي عناصر المصفوفة أو المجموعة التي لم تحقق شرطًا منطقيًّا محدَّدًا.

filterNotNull

تعيد الدالة filterNotNull()‎ جميع عناصر المصفوفة أو المجموعة المعطاة باستثناء تلك ذات القيمة null.

filterNotNullTo

تشبه الدالة filterNotNullTo()‎ الدالة filterNotNull() في جميع النواحي باستثناء أنَّها تضيف الناتج الذي تعيده إلى المعامل المُمرَّر إليها.

filterNotTo

تشبه الدالة filterNotTo()‎ الدالة filterNot()‎ في جميع النواحي باستثناء أنَّها تضيف الناتج المعاد إلى المعامل الممرَّر إليها.

filterTo

تشبه هذه الدالة filterTo()‎ الدالة filter()‎ في جميع النواحي باستثناء أنها تضيف الناتج إلى المعامل المُمرَّر إليها.

find

تبحث الدالة find()‎ على عنصر محدَّد ضمن عناصر المصفوفة أو المجموعة التي استُدعيت معها ثمَّ تعيد أول ظهور له.

findLast

تبحث الدالة findLast()‎ على عنصر محدَّد ضمن عناصر المصفوفة أو المجموعة التي استُدعيت معها ثمَّ تعيد آخر ظهور له.

first

تجلب الدالة first()‎ أول عنصر من عناصر المصفوفة أو المجموعة التي استُدعيت معها إن لم يمرر إليها أي شيء، أو أول عنصر يحق شرطًا معيَّنًا في حال تمرير دالة منطقية إليها.

firstOrNull

تجلب الدالة firstOrNull()‎ أول عنصر من عناصر المصفوفة أو المجموعة التي استُدعيت معها إن لم يُمرَّر إليها أي شيء، أو أول عنصر يحقق شرطًا معيَّنًا في حال تمرير دالة منطقية إليها.

flatMap

تعيد الدالة flatMap()‎ قائمةً تضم ناتج تطبيق الدالة المُمرّرة إليها على عناصر المصفوفة، أو المجموعة، أو الخريطة التي استُدعيت معها.

flatMapTo

تشبه الدالة flatMapTo()‎ الدالة flatMap()‎ تمامًا باستثناء أنها تضيف الناتج المعاد إلى كائن موجود مسبقًا بدلًا من إعادته فقط.

flatten

تعيد الدالة flatten()‎ قائمة واحدة تحوي جميع عناصر المصفوفات أو المجموعات المتشعبة ضمن المصفوفة أو المجموعة التي استُدعيت معها.

fold

تجمع الدالة fold()‎ تراكميًّا ناتج تطبيق عملية معينة على قيمة كل عنصر من عناصر الكائن المستدعى معها والقيمة التراكمية الحالية بالإضافة إلى قيمة أولية إن أعطيت.

foldIndexed

تجمع الدالة foldIndexed()‎ ناتج تطبيق عملية معينة على قيمة كل عنصر من عناصر المصفوفة أو المجموعة (بدءًا من اليسار إلى اليمين) المستدعاة معها وفهرس ذلك العنصر بشكل تراكمي بالإضافة إلى القيمة الأولية إن أعطيت.

foldRight

تجمع الدالة foldRight()‎ بشكل تراكمي ناتج تطبيق عملية معيَّنة على قيمة كل عنصر من عناصر المصفوفة أو المجموعة (بدءًا من اليمين إلى اليسار) المستدعاة معها والقيمة التراكمية الحالية بالإضافة إلى القيمة الأولية إن أعطيت. 

foldRightIndexed

تجمع الدالة foldRightIndexed()‎ ناتج تطبيق عملية معينة على قيمة كل عنصر من عناصر المصفوفة أو المجموعة (بدءًا من اليمين إلى اليسار) المستدعاة معها وفهرس ذلك العنصر بشكل تراكمي بالإضافة إلى القيمة الأولية إن أعطيت.

forEach

تُنفّد الدالةُ forEach()‎ الدالةَ المُمرّرةَ إليها على كل عنصر من عناصر المصفوفة أو المجموعة أو الخريطة التي استُدعيت معها.

forEachIndexed

تُنفّد الدالةُ forEachIndexed()‎ الدالةَ المُمرّرةَ إليها على كل عنصر من عناصر المصفوفة، أو المجموعة، أو الخريطة، التي استُدعيت معها وعلى فهرس ذلك العنصر. 

getOrElse

تجلب الدالة getOrElse()‎ عنصرًا ذا فهرس مُحدَّد من المصفوفة أو المجموعة التي استُدعيت معها أو القيمة المقابلة لمفتاح محدَّد إن استدعيت مع خريطة.

getOrNull

تجلب الدالة getOrNull()‎ عنصرًا ذا فهرس مُحدَّد من المصفوفة أو المجموعة التي استُدعيت معها أو تعيد القيمة null إن كان الفهرس المعطى يقع خارج حدود المصفوفة أو المجموعة.

groupBy

تجمِّع الدالة groupBy()‎ عناصر المصفوفة أو المجموعة التي استُدعيت معها في مجموعات، إذ تطبق دالة محدَّدة على كل عنصر ثمَّ تعاد خريطة تحوي مجموعاتٍ مفتاحُ كلِّ واحدةٍ منها مرتبطٌ بقائمة من العناصر المقابلة.

groupByTo

تشبه الدالة groupByTo()‎ الدالة groupBy()‎ في جميع النواحي باستثناء أنَّها تضيف الناتج المعاد إلى المعامل الممرَّر إليها.

groupingBy

تُنشئ الدالة groupingBy()‎ موردًا (source) من النوع Grouping من المصفوفة أو المجموعة التي استُدعيت معها لاستخدامه لاحقًا مع عمليات التجميع (group-and-fold operations) وذلك باستخدام الدالة keySelector المُمرّرة إليها لاستخلاص مفتاح من كل عنصر.

indexOf

تجلب الدالة indexOf()‎ فهرس أول ظهور لعنصر محدَّد من المصفوفة أو المجموعة أو القائمة التي استُدعيت معها.

indexOfFirst

تجلب الدالة indexOfFirst()‎ فهرس أول عنصر يحقِّق شرطًا معيَّنًا من المصفوفة أو المجموعة أو القائمة التي استُدعيت معها.

indexOfLast

تجلب الدالة indexOfLast()‎ فهرس آخر عنصر يحقِّق شرطًا معيَّنًا من المصفوفة أو المجموعة أو القائمة التي استُدعيت معها.

intersect

تبحث الدالة intersect()‎ عن العناصر المشتركة بين مصفوفتين أو مجموعتين ثمَّ تعيدها في مجموعة.

isArrayOf

تتحقَّق الدالة isArrayOf()‎ من حواية المصفوفة التي استُدعيت معها عناصرَ من نوعٍ محدَّد.

isEmpty

تتحقق الدالة isEmpty()‎ إن كانت المصفوفة التي استُدعيت معها فارغةً أم لا.

isNotEmpty

تتحقَّق الدالة isNotEmpty()‎ إن كانت المصفوفة أو المجموعة التي استُدعيت معها فارغةً أم لا.

joinTo

تضيف الدالة joinTo()‎ بادئة ولاحقة إلى جميع عناصر المصفوفة أو المجموعة التي استُدعيت معها (أو جزءٍ منها) وتفصلها بفاصلة معينة ثمَّ تضيفها إلى سلسة نصية موجودة مسبقًا.

joinToString

تضيف الدالة joinToString()‎ بادئة ولاحقة إلى جميع عناصر المصفوفة أو المجموعة التي استُدعيت معها (أو جزءٍ منها) بعد فصل عناصرها بفاصلة معينة ثمَّ تضع الناتج في سلسة نصيةجديدة تنشئها آنذاك.

last

تجلب الدالة last()‎ آخر عنصر من عناصر المصفوفة أو المجموعة التي استُدعيت معها إن لم يمرر إليها أي شيء، أو آخر عنصر يحق شرطًا معيَّنًا في حال تمرير دالة منطقية إليها.

lastIndexOf

تجلب الدالة lastIndexOf()‎ فهرس آخر ظهور لعنصر محدَّد من المصفوفة أو المجموعة أو القائمة التي استُدعيت معها.

lastOrNull

تجلب الدالة lastOrNull()‎ آخر عنصر من عناصر المصفوفة أو المجموعة التي استُدعيت معها إن لم يُمرَّر إليها أي شيء، أو آخر عنصر يحقق شرطًا معيَّنًا في حال تمرير دالة منطقية إليها.

map

تعيد الدالة map()‎ قائمةً تحوي ناتج تطبيق الدالة المُمرّرة إليها على كل عنصر من عناصر المصفوفة أو المجموعة أو الخريطة التي استُدعيت معها.

mapIndexed

تعيد الدالة mapIndexed()‎ قائمةً تحوي ناتج تطبيق الدالة المُمرّرة إليها على فهرس وقيمة كل عنصر من عناصر المصفوفة أو المجموعة التي استُدعيت معها.

mapIndexedNotNull

تعيد الدالة mapIndexedNotNull()‎ قائمةً تحوي ناتج تطبيق الدالة المُمرّرة إليها على فهرس وقيمة كل عنصر من عناصر المصفوفة أو المجموعة التي استُدعيت معها باستثناء القيم العدميَّةnull التي تعيدها تلك الدالة.

mapIndexedNotNullTo

تشبه الدالة mapIndexedNotNullTo()‎ الدالة mapIndexedNotNull()‎ تمامًا باستثناء أنها تضيف الناتج المعاد إلى المعامل الممرَّر إليها.

mapIndexedTo

تشبه الدالة mapIndexedTo()‎ الدالةَ mapIndexed()‎ في جميع النواحي باستثناء أنها تضيف الناتج المعاد إلى المعامل الممرَّر إليها.

mapNotNull

تعيد الدالة mapNotNull()‎ قائمةً تحوي ناتج تطبيق الدالة المُمرّرة إليها على كل عنصر من عناصر المصفوفة أو المجموعة أو الخريطة التي استُدعيت معها باستثناء القيم العدميَّة null التي تعيدها تلك الدالة.

mapNotNullTo

تشبه الدالة mapNotNullTo()‎ الدالة mapNotNull()‎ تمامًا باستثناء أنها تضيف الناتج المعاد إلى المعامل المُمرَّر إليها بدلًا من وضعه في قائمة.

mapTo

تشبه الدالة mapTo()‎ الدالة map()‎ باستثناء أنَّها تضيف الناتج المعاد إلى المعامل المُمرَّر إليها بدلًا من وضعه في قائمة.

max

تجلب الدالة max()‎ أكبر عنصر في المصفوفة أو المجموعة التي استُدعيت معها.

maxBy

تجلب الدالة maxBy()‎ العنصر أو الزوج الأول من المصفوفة أو المجموعة أو الخريطة التي استُدعيت معها والذي أعيدت معه أكبر قيمة عند تطبيق دالة معيَّنة عليه.

maxWith

تجلب الدالة maxWith()‎ العنصر أو الزوج الأول من المصفوفة أو المجموعة أو الخريطة التي استُدعيت معها والذي له أكبر قيمة بحسب الموازن comparator المعطى.

min

تجلب الدالة min()‎ أصغر عنصر في المصفوفة أو المجموعة التي استُدعيت معها.

minBy

تجلب الدالة minBy()‎ العنصر أو الزوج الأول من المصفوفة أو المجموعة أو الخريطة التي استُدعيت معها والذي أعيدت معه أصغر قيمة عند تطبيق دالة معيَّنة عليه.

minWith

تجلب الدالة minWith()‎ العنصر أو الزوج الأول من المصفوفة أو المجموعة أو الخريطة التي استُدعيت معها والذي له أصغر قيمة بحسب الموازن comparator المعطى.

none

تتحقَّق الدالة none()‎ إن كانت المصفوفة أو المجموعة أو الخريطة التي استدعيت معها فارغةً، أو إن لم يكن هنالك أي عنصر من تلك العناصر محقِّقًا لشرط معين.

orEmpty

تعيد الدالة orEmpty()‎ المصفوفة أو المجموعة أو القائمة أو الخريطة التي استُدعيت معها إن لم تكن مساويةً للقيمة null، أو تعيد كائنًا فارغًا يقابل الكائن المعطى (مصفوفة فارغة، أو مجموعة فارغة ...إلخ.) خلاف ذلك.

partition

تقسم الدالة partition()‎ المصفوفة أو المجموعة التي استُدعيت معها إلى قسمين؛ الأول يضم العناصر التي تحقِّق شرطًا محدَّدًا، والثاني يضم العناصر الأخرى المتبقيَّة.

plus

تضيف الدالة plus()‎ الوسيط المُمرَّر إليها إلى الكائن الذي استدعيت معه.

plusElement

تضيف الدالة plusElement()‎ العنصر المُمرّر إليها إلى المصفوفة أو المجموعة التي استُدعيت معها.

reduce

تُراكِم الدالة reduce()‎ قيمة عنصر بدءًا من العنصر الأول عبر تطبيق عملية معينة من يسار العناصر المعطاة إلى يمينها على القيمة المتراكمة الحالية وعلى العنصر التالي ثم تُعيد قيمة العنصر النهائي الناتج.

reduceIndexed

تجمع الدالة reduceIndexed()‎ ناتج تطبيق عملية معينة على قيمة كل عنصر من عناصر المصفوفة أو المجموعة (بدءًا من اليسار إلى اليمين) المستدعاة معها وفهرس ذلك العنصر بشكل تراكمي والقيمة المجمَّعة الحالية.

reduceRight

تجمع الدالة reduceRight()‎ بشكل تراكمي ناتج تطبيق عملية معيَّنة على قيمة كل عنصر من عناصر المصفوفة أو المجموعة (بدءًا من اليمين إلى اليسار) المستدعاة معها والقيمة التراكمية الحالية. 

reduceRightIndexed

تجمع الدالة reduceRightIndexed()‎ الناتج التراكمي لتطبيق عملية معينة على قيمة كل عنصر من عناصر المصفوفة أو المجموعة (بدءًا من اليمين إلى اليسار) المستدعاة معها وفهرس ذلك العنصر والقيمة المجمَّعة الحالية. 

requireNoNulls

تعيد الدالة requireNoNulls()‎ العناصر غير المعدومة (non-null) من المصفوفة أو المجموعة أو القائمة التي استُدعيت معها أو ترمي استثناءً إن وجد عنصر معدوم (null).

reverse

تعكس الدالة reverse()‎ ترتيب عناصر المصفوفة أو القائمة التي استُدعيت معها.

reversed

تُعيد الدالة reversed()‎ قائمة تضم عناصر المصفوفة أو المجموعة التي استُدعيت معها بترتيب معكوس.

reversedArray

تعيد الدالة reversedArray()‎ مصفوفةً تضم عناصر المصفوفة التي استُدعيت معها بترتيب معكوس.

single

تتحقَّق الدالة single()‎ من حواية المصفوفة أو المجموعة أو القائمة التي استُدعيت معها عنصرًا واحدًا فقط أو عنصرًا واحدًا محققًا لشرط معيَّن ثمَّ تعيده أو تطلق استثناءً خلاف ذلك.

singleOrNull

تتحقَّق الدالة singleOrNull()‎ من حواية المصفوفة أو المجموعة أو القائمة التي استُدعيت معها عنصرًا واحدًا فقط، أو عنصرًا واحدًا محققًا لشرط معيَّن ثمَّ تعيده، أو تعيد القيمة nullخلاف ذلك.

slice

تقطع الدالة slice()‎ جزءًا محدَّدًا من المصفوفة أو القائمة التي استُدعيت معها ثمَّ تعيده في قائمة.

sliceArray

تقطع الدالة sliceArray()‎ جزءًا محدَّدًا من المصفوفة التي استُدعيت معها ثمَّ تعيده في مصفوفة أو قائمة بحسب الوسيط الممرر إليها. 

sort

ترتِّب الدالة sort()‎ المصفوفة أو القائمة المتغيرة (MutableList) التي استُدعيت معها تصاعديًّا.

sortBy

ترتِّب الدالة sortBy()‎ عناصر المصفوفة أو القائمة المتغيرة (MutableList) التي استُدعيت معها تصاعديًّا وفقًا للقيم التي تعيدها الدالة المُمرّرة إليها عند تطبيقها على كل عنصر.

sortByDescending

ترتِّب الدالة sortByDescending()‎ عناصر المصفوفة أو القائمة المتغيرة (MutableList) التي استُدعيت معها تنازليًّا وفقًا للقيم التي تعيدها الدالة المُمرّرة إليها عند تطبيقها على كل عنصر. 

sortDescending

ترتِّب الدالة sortDescending()‎ المصفوفة أو القائمة المتغيرة (MutableList) التي استُدعيت معها تنازليًّا. 

sortWith

ترتِّب الدالة sortWith()‎ جميع عناصر المصفوفة أو القائمة المتغيرة (MutableList) التي استُدعيت معها أو جزءًا محدَّدًا منها تنازليًا وفقًا للمُقارن المُمرّر إليها.

sorted

ترتِّب الدالة sorted()‎ جميع عناصر المصفوفة أو المجموعة التكرارية التي استُدعيت معها تصاعديًّا ثمَّ تضع الناتج في قائمة.

sortedArray

ترتِّب الدالة sortedArray()‎ جميع عناصر المصفوفة التي استُدعيت معها تصاعديًّا ثمَّ تضع الناتج في مصفوفة جديدة. 

sortedArrayDescending

ترتِّب الدالة sortedArrayDescending()‎ جميع عناصر المصفوفة التي استُدعيت معها تنازليًّا ثمَّ تضع الناتج في مصفوفة جديدة. 

sortedArrayWith

ترتِّب الدالة sortedArrayWith()‎ جميع عناصر المصفوفة التي استُدعيت معها وفقًا للمُقارِن المُمرّر إليها ثمَّ تضع الناتج في مصفوفة جديدة. 

sortedBy

ترتِّب الدالة sortedBy()‎ جميع عناصر المصفوفة أو المجموعة التكرارية (Iterable) التي استُدعيت معها تصاعديًّا وفقًا للقيم التي تعيدها الدالة المُمرّرة إليها عند تطبيقها على كل عنصر ثمَّ تضع الناتج في قائمة.

sortedByDescending

ترتِّب الدالة sortedByDescending()‎ جميع عناصر المصفوفة أو المجموعة التكرارية (Iterable) التي استُدعيت معها تنازليًّا وفقًا للقيم التي تعيدها الدالة المُمرّرة إليها عند تطبيقها على كل عنصر ثمَّ تضع الناتج في قائمة.

sortedDescending

ترتِّب الدالة sortedDescending()‎ جميع عناصر المصفوفة أو المجموعة التكرارية التي استُدعيت معها تنازليًّا ثمَّ تضع الناتج في قائمة.

sortedWith

ترتِّب الدالة sortedWith()‎ جميع عناصر المصفوفة أو المجموعة التكرارية التي استُدعيت معها وفقًا للمُقارِن المُمرّر إليها ثمَّ تضع الناتج في قائمة.

subtract

تستثني الدالة subtract()‎ العناصر المشتركة بين كائنين.

sum

تجمع الدالة sum()‎ جميع قيم عناصر المصفوفة أو المجموعة التي استُدعيت معها ثمَّ تعيد الناتج.

sumBy

تجمع الدالة sumBy()‎ جميع نواتج تطبيق دالة معيَّنة على كل عنصر من عناصر المصفوفة أو المجموعة التي استُدعيت معها.

sumByDouble

تجمع الدالة sumByDouble()‎ جميع نواتج تطبيق دالة معيَّنة على كل عنصر من عناصر المصفوفة أو المجموعة التي استُدعيت معها.

take

تجلب الدالة take()‎ أول n عنصر من المصفوفة أو المجموعة التكرارية التي استُدعيت معها وتضعها في قائمة.

takeLast

تجلب الدالة takeLast()‎ آخر n عنصر من المصفوفة أو المجموعة التكرارية التي استُدعيت معها وتضعها في قائمة. 

takeLastWhile

تجلب الدالة takeLastWhile()‎ آخر عناصر محققة لشرطٍ محدَّدٍ من المصفوفة أو القائمة التي استُدعيت معها.

takeWhile

تجلب الدالة takeWhile()‎ أول عناصر محققة لشرطٍ محدَّدٍ من المصفوفة أو القائمة التي استُدعيت معها. 

toBooleanArray

تحول الدالة toBooleanArray()‎ المصفوفة العامة (أي من النوع Array<out Boolean>‎) أو المجموعة التي استُدعيت معها إلى مصفوفة من قيم منطقية (أي من النوعBooleanArray) .

toByteArray

تحوِّل الدالة toByteArray()‎ المصفوفة العامة (أي من النوع Array<Byte>‎) أو المجموعة التي استُدعيت معها إلى مصفوفة من النوع ByteArray.

toCharArray

تحول الدالة toCharArray()‎ المصفوفة العامة (أي التي من النوع Array<Char>‎) أو المجموعة التي استُدعيت معها إلى مصفوفة من النوع CharArray.

toCollection

تضيف الدالة toCollection()‎ جميع عناصر المصفوفة أو المجموعة التي استُدعيت معها إلى المجموعة المتغيرة (MutableCollection) المُمرّرة إليها.

toDoubleArray

تحول الدالة toDoubleArray()‎ المصفوفة العامة (أي من النوع Array<Double>‎) أو المجموعة التي استُدعيت معها إلى مصفوفة من النوع DoubleArray.

toFloatArray

تحول الدالة toFloatArray()‎ المصفوفة العامة (أي من النوع Array<Float>‎) أو المجموعة  التي استُدعيت معها مصفوفة من النوع FloatArray.

toHashSet

تعيد الدالة toHashSet()‎ كائنًا من النوع HashSet لجميع عناصر المصفوفة أو المجموعة التي استُدعيت معها.

toIntArray

تحول الدالة toIntArray()‎ المصفوفة العامة (أي من النوع Array<Int>‎) أو المجموعة التي استُدعيت معها إلى مصفوفة من النوع IntArray.

toList

تحول الدالة toList()‎ المصفوفة أو المجموعة التكرارية أو الخريطة التي استُدعيت معها إلى قائمة.

toLongArray

تحول الدالة toList()‎ المصفوفة أو المجموعة التكرارية أو الخريطة التي استُدعيت معها إلى قائمة.

toMap

تحول الدالة toLongArray()‎ المصفوفة العامة (أي من النوع Array<Long>‎) أو المجموعة التي استُدعيت معها إلى مصفوفة من النوع LongArray.

toMutableList

تحول الدالة toMutableList()‎ المصفوف أو المجموعة التي استُدعيت معها إلى قائمة متغيرة.

toMutableSet

تحول الدالة toMutableSet()‎ المصفوفة أو المجموعة التكرارية التي استُدعيت معها إلى مجموعة من النوع MutableSet؛ تحافظ المجموعة المُعادة على نفس ترتيب تكرار المصفوفة أو المجموعة التكرارية الأصلية.

toSet

تحول الدالة toSet()‎ المصفوفة أو المجموعة التكرارية التي استُدعيت معها إلى مجموعة من النوع Set. تحافظ المجموعة المُعادة على نفس ترتيب تكرار المصفوفة أو المجموعة التكرارية الأصلية. 

toShortArray

تحول الدالة toShortArray()‎ المصفوفة العامة (أي من النوع Array<Short>‎) أو المجموعة التي استُدعيت معها إلى مصفوفة من النوع ShortArray.

toSortedSet

تحول الدالة toSortedSet()‎ المصفوفة أو المجموعة التكرارية التي استُدعيت معها إلى مجموعة من النوع SortedSet ثمَّ تعيدها فقط إن لم يمرَّر إليها أي شيء، أو ترتِّبها وفقًا لترتيب معيَّن ثمَّ تعيدها إن مرِّرت إليها دالة مقارنة.

union

تجمع الدالة union()‎ العناصر المشتركة وغير المتشركة بين المصفوفة أو المجموعة التكرارية التي استُدعيت معها وبين المجموعة التكرارية المُمرّرة إليها في مجموعةٍ واحدةٍ من النوع Set بعد حذف العناصر المتكررة.

unzip

تعيد الدالة unzip()‎ قائمتين، إذ تحتوي الأولى على القيم الأولى لكل زوج من أزواج المصفوفة أو المجموعة التكرارية التي استُدعيت معها وتحتوي الثانية على القيم الثانية لكل زوج من تلك الأزواج.

withIndex

تعيد الدالة withIndex()‎ مجموعة تكرارية خاملة (lazy Iterable) من القيم المُفهرسة لكل عنصر من عناصر المصفوفة أو المجموعة التكرارية التي استُدعيت معها، أو تعيد مُكرّرًا (iterator) يغلّف كل عنصر أنتجه المكرّر (Iterator) المستدعى مع الدالة مع القيمة المُفهرسة أي يعيد القيمة مع فهرسها.

zip

تنشئ الدالة zip()‎ أزواجًا من عناصر كائنين لها نفس الفهرس، أو تنشئ قيمًا عبر تمرير عناصر لها نفس الفهرس تجلب من كائنين مختلفين إلى دالة معينة.

مصادر