الفرق بين المراجعتين لصفحة: «Kotlin/Array»
< Kotlin
جميل-بيلوني (نقاش | مساهمات) طلا ملخص تعديل |
جميل-بيلوني (نقاش | مساهمات) لا ملخص تعديل |
||
| سطر 1: | سطر 1: | ||
== الدوال والخاصيات == | <nowiki/>يمثل الصنف <code>Array</code> مصفوفة (مصفوفة Java تحديدًا عند استهداف المنصة JVM). يمكن إنشاء نسخ من هذا الصنف باستعمال الدوال [[Kotlin/arrayOf|<code>()arrayOf</code>]] و [[Kotlin/arrayOfNulls|<code>()arrayOfNulls</code>]] و [[Kotlin/emptyArray|<code>()emptyArray</code>]] الخاصة بالمكتبة القياسية. للمزيد من المعلومات حول المصفوفات، ارجع إلى قسم "المصفوفات" في توثيق الأنواع الأساسية.<nowiki/><syntaxhighlight lang="kotlin"> | ||
class Array<T> | |||
=== <code>[[Kotlin/Array/size|size]]</code> === | </syntaxhighlight> | ||
==الدوال البانية== | |||
===<code>[[Kotlin/Any/Init|<int>]]</code>=== | |||
تنشِئ الدالة <code>Array()</code> البانية مصفوفةً بحجم <code>size</code> مُحدَّدٍ، حيث يُحسَب كلُّ عنصرٍ فيها عبر استدعاء الدالة <code>init</code> المُحدَّدة، والتي تُعيد عنصرًا في المصفوفة بحسب الفهرس (index) المُعطى. | |||
==الدوال والخاصيات== | |||
===<code>[[Kotlin/Array/size|size]]</code>=== | |||
تمثِّل الخاصيّة <code>size</code> عدد العناصر الموجودة في المصفوفة (array). | تمثِّل الخاصيّة <code>size</code> عدد العناصر الموجودة في المصفوفة (array). | ||
===<code>[[Kotlin/Array/iterator|iterator]]</code>=== | |||
=== <code>[[Kotlin/Array/iterator|iterator]]</code> === | تعيد هذه الدالة عنصرًا تكراريًّا (iterator) بهدف تطبيق حلقة تكرار (loop) برمجيةٍ على كافّة عناصر المصفوفة. | ||
===<code>[[Kotlin/Array/get|get]]</code>=== | |||
تعيد هذه الدالة قيمة عنصر محدد بعد تمرير فهرسه (index) إليه. | |||
=== <code>[[Kotlin/Array/get|get]]</code> === | ==الدوال الموروثة== | ||
===<code>[[Kotlin/Any/equals|equals]]</code>=== | |||
تحدد الدالة <code>equals()</code> إذا ما كان الكائن المُمرّر إليها يساوي الكائن الذي استدعيت معها. | |||
== الدوال الموروثة== | ===<code>[[Kotlin/Any/hashCode|hashCode]]</code>=== | ||
=== <code>[[Kotlin/Any/equals|equals]]</code> === | تعيد الدالة <code>hashCode()</code> قيمة الشيفرة Hash الخاصّة بالكائن الذي استُدعي معها. | ||
تحدد الدالة <code>equals()</code> إذا ما كان الكائن المُمرّر إليها يساوي الكائن الذي استدعيت | ===<code>[[Kotlin/Any/toString|toString]]</code>=== | ||
تحول الدالة <code>toString()</code> الكائن الذي يُستدعى معها إلى سلسلة نصية. | |||
=== <code>[[Kotlin/Any/hashCode|hashCode]]</code> === | ==الخاصيات الإضافية (Extension Properties)== | ||
===<code>[[Kotlin/collections/indices|indices]]</code>=== | |||
=== <code>[[Kotlin/Any/toString|toString]]</code> === | |||
== الخاصيات الإضافية (Extension Properties) == | |||
=== <code>[[Kotlin/collections/indices|indices]]</code> === | |||
تُستخدَم هذه الخاصيّة للحصول على الفهارس الصحيحة (valid indices) للمصفوفة أو المجموعة (collection). | تُستخدَم هذه الخاصيّة للحصول على الفهارس الصحيحة (valid indices) للمصفوفة أو المجموعة (collection). | ||
===<code>[[Kotlin/collections/lastIndex|lastIndex]]</code>=== | |||
=== <code>[[Kotlin/collections/lastIndex|lastIndex]]</code> === | تُستخدَم هذه الخاصيّة لجلب الفهرس (index) الأخير لمصفوفة أو قائمة (list). | ||
تُستخدَم هذه الخاصيّة | ==الدوال الإضافية (Extension Functions)== | ||
===<code>[[Kotlin/collections/all|all]]</code>=== | |||
== الدوال الإضافية (Extension Functions) == | تتحقق الدالة <code>all()</code> إن كانت كافّة عناصر المصفوفة أو المجموعة (collection) التي استُدعيت عبرها تطابق شرطًا منطقيًّا محدَّدًا. | ||
=== <code>[[Kotlin/collections/all|all]]</code> === | ===<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>[[Kotlin/collections/asList|asList]]</code>=== | |||
تُعيد الدالة <code>asList()</code> قائمةً (list) تُغلّف المصفوفة الأصلية التي استُدعيت عبرها. | |||
=== <code>[[Kotlin/collections/asList|asList]]</code> === | ===<code>[[Kotlin/collections/asSequence|asSequence]]</code>=== | ||
تُعيد الدالة <code>asList()</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/asSequence|asSequence]]</code> === | تعيد الدالة <code>associate()</code> خريطةً (map) تحوي أزواجًا من "مفتاح/قيمة" ناتجة عن تمرير عناصر المصفوفة أو المجموعة ([[Kotlin/collections|Collection]]) إلى الدالة المررة إليها. | ||
===<code>[[Kotlin/collections/associateBy|associateBy]]</code>=== | |||
تعيد الدالة <code>associateBy()</code> خريطةً (map) مكونة من الأزواج "مفتاح/قيمة"، إذ يكون المفتاح (key) هو الناتج الذي تعيده الدالة <code>keySelector</code> الممررة إليها وتكون القيمة (value) المقابلة لذلك المفتاح هي إمَّا عناصر المصفوفة أو المجموعة المعطاة أو الناتج الذي تعيده الدالة <code>valueTransform</code> الممررة. | |||
=== <code>[[Kotlin/collections/associate|associate]]</code> === | ===<code>[[Kotlin/collections/associateByTo|associateByTo]]</code>=== | ||
تعيد الدالة <code>associate()</code> | تشبه الدالة <code>associateByTo()</code> الدالة <code>[[Kotlin/collections/associateBy|associateBy()]]</code> تمامًا باستثناء أنها تضيف الناتج الذي تعيده إلى خريطة موجودة مسبقًا. | ||
===<code>[[Kotlin/collections/associateTo|associateTo]]</code>=== | |||
=== <code>[[Kotlin/collections/associateBy|associateBy]]</code> === | تشبه الدالة <code>associateTo()</code> الدالة <code>[[Kotlin/collections/associate|associate()]]</code> تمامًا باستثناء أنها تضيف الناتج الذي تعيده إلى خريطة موجودة مسبقًا. | ||
تعيد الدالة <code>associateBy()</code> خريطةً (map) | ===<code>[[Kotlin/collections/average|average]]</code>=== | ||
=== <code>[[Kotlin/collections/associateByTo|associateByTo]]</code> === | |||
=== <code>[[Kotlin/collections/associateTo|associateTo]]</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>binarySearch()</code> عن عنصر معين في المجموعة أو مجال من المجموعة ([[Kotlin/collections|Collection]]) باستخدام خوارزميَّة البحث الثنائي (binary search algorithm) وتعيد فهرس موقعه. ويجب أن تكون المجموعة مرتبَّةً وفق المُقارِن <code>comparator</code> وإلا فستكون النتيجة المعادة غير مُحدّدة. | |||
===<code>[[Kotlin/collections/component1|component1]]</code>=== | |||
تعيد الدالة <code>component1()</code> العنصر الأول من المصفوفة أو المفتاح (key) لأول زوج (مفتاح/قيمة) في الخريطة (map) التي استدعيت معها. تسمح هذه الدالة باستخدام التصريحات التفكيكية (destructuring declarations) عند العمل على الخرائط. | |||
===<code>[[Kotlin/collections/contains|contains]]</code>=== | |||
تتحقق الدالة <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>contentEquals()</code> من تساوي <nowiki/>[[Kotlin/Array|مصفوفتين]] بنيويًا (''structurally'' equal)، أي إن كان لهما نفس العناصر وبنفس العدد والترتيب. | |||
===<code>[[Kotlin/collections/contentHashCode|contentHashCode]]</code>=== | |||
تشفِّر الدالة <code>contentHashCode()</code> محتوى <nowiki/>[[Kotlin/Array|المصفوفة]] التي استُدعيت معها كما لو كانت قائمة إلى شيفرة Hash. | |||
===<code>[[Kotlin/collections/contentToString|contentToString]]</code>=== | |||
تعيد الدالة <code>contentToString()</code> سلسلة نصية تمثِّل محتوى <nowiki/>[[Kotlin/Array|المصفوفة]] التي استُدعيت معها كما لو كانت قائمة. | |||
===<code>[[Kotlin/collections/copyOf|copyOf]]</code>=== | |||
تنسخ الدالة <code>copyOf()</code> كامل <nowiki/>[[Kotlin/Array|المصفوفة]] التي استُدعيت معها أو جزءًا منها. | |||
===<code>[[Kotlin/collections/copyOfRange|copyOfRange]]</code>=== | |||
تنسخ الدالة <code>copyOfRange()</code> مجالًا محدَّدًا من <nowiki/>[[Kotlin/Array|المصفوفة]] التي استُدعيت معها. | |||
===<code>[[Kotlin/collections/count|count]]</code>=== | |||
تعيد الدالة <code>count()</code> عدد جميع عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] أو الخريطة التي استُدعيت معها أو العناصر التي تحقق شرطًا معينًا. | |||
===<code>[[Kotlin/collections/distinct|distinct]]</code>=== | |||
تحذف الدالة <code>distinct()</code> العناصر المتكررة الموجودة في <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت معها وتعيد الناتج في قائمة. | |||
===<code>[[Kotlin/collections/distinctBy|distinctBy]]</code>=== | |||
تعيد الدالة <code>distinctBy()</code> قائمة تحتوي على العناصر الموجودة في <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/Array|المجموعة]] التي استُدعيت معها والتي تعطي نتيجة مختلفة عند تطبيق الدالة <code>selector</code> عليها فقط. | |||
===<code>[[Kotlin/collections/drop|drop]]</code>=== | |||
تعيد الدالة <code>drop()</code> قائمة تحوي جميع عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/Array|المجموعة]] التي استُدعيت معها باستثناء أول <code>n</code> عنصر. | |||
===<code>[[Kotlin/collections/dropLast|dropLast]]</code>=== | |||
تعيد الدالة <code>dropLast()</code> قائمة تحوي جميع عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/Array|المجموعة]] التي استُدعيت معها باستثناء آخر <code>n</code> عنصر. | |||
===<code>[[Kotlin/collections/dropLastWhile|dropLastWhile]]</code>=== | |||
تعيد الدالة <code>dropLastWhile()</code> قائمةً تحوي جميع عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت معها باستثناء العناصر الأخيرة التي تحقق شرطًا معيَّنًا. | |||
تحتوي جميع عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/Array|المجموعة]] التي استُدعيت عبرها باستثناء العناصر الأخيرة التي تحقق الشرط المنطقي <code>predicate</code> المُمرّر إلى الدالة. | |||
=== <code>[[Kotlin/collections/ | ===<code>[[Kotlin/collections/dropWhile|dropWhile]]</code>=== | ||
تعيد الدالة<code> | تعيد الدالة <code>dropWhile()</code> [[Kotlin/List|قائمةً]] تحوي جميع عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت معها باستثناء العناصر الأولى التي تحقق شرطًا معيَّنًا. | ||
===<code>[[Kotlin/collections/elementAt|elementAt]]</code>=== | |||
=== <code>[[Kotlin/collections/elementAtOrNull|elementAtOrNull]]</code> === | تجلب الدالة <code>elementAt()</code> عنصرًا ذي فهرس معيَّن من <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت معها. | ||
===<code>[[Kotlin/collections/elementAtOrElse|elementAtOrElse]]</code>=== | |||
تجلب الدالة <code>elementAtOrElse()</code> عنصرًا ذي فهرس معيَّن من <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت معها. إن كان الفهرس المعطى خارج حدود <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/Array|المجموعة]]، فستُعيد الدالة ناتج استدعاء دالة معينة. | |||
===<code>[[Kotlin/collections/elementAtOrNull|elementAtOrNull]]</code>=== | |||
تعيد الدالة<code>elementAtOrNull()</code> العنصر الموجود عند الفهرس (index) المحدد من <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/Array|المجموعة]] التي استُدعيت عبرها، وفي حال كان ذلك الفهرس خارج حدود <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>[[Kotlin/collections/filter|filter]]</code>=== | |||
ترشِّح الدالة <code>filter()</code> عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] أو أزواج الخرائط المعطاة التي تحقِّق شرطًا معيَّنًا ثمّ تعيدها. | |||
=== <code>[[Kotlin/collections/filter|filter]]</code> === | ===<code>[[Kotlin/collections/filterIndexed|filterIndexed]]</code>=== | ||
ترشِّح الدالة <code>filterIndexed()</code> عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] المعطاة بناءً على فهرس العنصر وقيمته. | |||
===<code>[[Kotlin/collections/filterIndexedTo|filterIndexedTo]]</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/ | ===<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/ | تعيد الدالة <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/ | تشبه الدالة <code>filterNotTo()</code> الدالة <code>[[Kotlin/collections/filterNot|filterNot()]]</code> في جميع النواحي باستثناء أنَّها تضيف الناتج المعاد إلى المعامل الممرَّر إليها. | ||
===<code>[[Kotlin/collections/filterTo|filterTo]]</code>=== | |||
تشبه هذه الدالة <code>filterTo()</code> الدالة <code>[[Kotlin/collections/filter|filter()]]</code> في جميع النواحي باستثناء أنها تضيف الناتج إلى المعامل المُمرَّر إليها. | |||
=== <code>[[Kotlin/collections/ | ===<code>[[Kotlin/collections/find|find]]</code>=== | ||
تبحث الدالة <code>find()</code> على عنصر محدَّد ضمن عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت معها ثمَّ تعيد أول ظهور له. | |||
===<code>[[Kotlin/collections/findLast|findLast]]</code>=== | |||
=== <code>[[Kotlin/collections/ | تبحث الدالة <code>findLast()</code> على عنصر محدَّد ضمن عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت معها ثمَّ تعيد آخر ظهور له. | ||
===<code>[[Kotlin/collections/first|first]]</code>=== | |||
تجلب الدالة <code>first()</code> أول عنصر من عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت معها إن لم يمرر إليها أي شيء، أو أول عنصر يحق شرطًا معيَّنًا في حال تمرير دالة منطقية إليها. | |||
=== <code>[[Kotlin/collections/ | ===<code>[[Kotlin/collections/firstOrNull|firstOrNull]]</code>=== | ||
تجلب الدالة <code>firstOrNull()</code> أول عنصر من عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت معها إن لم يُمرَّر إليها أي شيء، أو أول عنصر يحقق شرطًا معيَّنًا في حال تمرير دالة منطقية إليها. | |||
===<code>[[Kotlin/collections/flatMap|flatMap]]</code>=== | |||
تعيد الدالة <code>flatMap()</code> قائمةً تضم ناتج تطبيق الدالة المُمرّرة إليها على عناصر <nowiki/>[[Kotlin/Array|المصفوفة]]، أو <nowiki/>[[Kotlin/collections|المجموعة]]، أو الخريطة التي استُدعيت معها. | |||
===<code>[[Kotlin/collections/flatMapTo|flatMapTo]]</code>=== | |||
=== <code>[[Kotlin/collections/ | تشبه الدالة <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>fold()</code> تراكميًّا ناتج تطبيق عملية معينة على قيمة كل عنصر من عناصر الكائن المستدعى معها والقيمة التراكمية الحالية بالإضافة إلى قيمة أولية إن أعطيت. | |||
===<code>[[Kotlin/collections/foldIndexed|foldIndexed]]</code>=== | |||
تجمع الدالة <code>foldIndexed()</code> ناتج تطبيق عملية معينة على قيمة كل عنصر من عناصر المصفوفة أو المجموعة (بدءًا من اليسار إلى اليمين) المستدعاة معها وفهرس ذلك العنصر بشكل تراكمي بالإضافة إلى القيمة الأولية إن أعطيت. | |||
===<code>[[Kotlin/collections/foldRight|foldRight]]</code>=== | |||
=== <code>[[Kotlin/collections/ | تجمع الدالة <code>foldRight()</code> بشكل تراكمي ناتج تطبيق عملية معيَّنة على قيمة كل عنصر من عناصر المصفوفة أو المجموعة (بدءًا من اليمين إلى اليسار) المستدعاة معها والقيمة التراكمية الحالية بالإضافة إلى القيمة الأولية إن أعطيت. | ||
===<code>[[Kotlin/collections/foldRightIndexed|foldRightIndexed]]</code>=== | |||
تجمع الدالة <code>foldRightIndexed()</code> ناتج تطبيق عملية معينة على قيمة كل عنصر من عناصر المصفوفة أو المجموعة (بدءًا من اليمين إلى اليسار) المستدعاة معها وفهرس ذلك العنصر بشكل تراكمي بالإضافة إلى القيمة الأولية إن أعطيت. | |||
=== <code>[[Kotlin/collections/ | ===<code>[[Kotlin/collections/forEach|forEach]]</code>=== | ||
تُنفّد الدالةُ <code>forEach()</code> الدالةَ المُمرّرةَ إليها على كل عنصر من عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] أو الخريطة التي استُدعيت معها. | |||
===<code>[[Kotlin/collections/forEachIndexed|forEachIndexed]]</code>=== | |||
تُنفّد الدالةُ <code>forEachIndexed()</code> الدالةَ المُمرّرةَ إليها على كل عنصر من عناصر <nowiki/>[[Kotlin/Array|المصفوفة]]، أو <nowiki/>[[Kotlin/collections|المجموعة]]، أو الخريطة، التي استُدعيت معها وعلى فهرس ذلك العنصر. | |||
===<code>[[Kotlin/collections/getOrElse|getOrElse]]</code>=== | |||
تجلب الدالة <code>getOrElse()</code> عنصرًا ذا فهرس مُحدَّد من <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت معها أو القيمة المقابلة لمفتاح محدَّد إن استدعيت مع خريطة. | |||
===<code>[[Kotlin/collections/getOrNull|getOrNull]]</code>=== | |||
تجلب الدالة <code>getOrNull()</code> عنصرًا ذا فهرس مُحدَّد من <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت معها أو تعيد القيمة <code>null</code> إن كان الفهرس المعطى يقع خارج حدود المصفوفة أو المجموعة. | |||
=== <code>[[Kotlin/collections/ | ===<code>[[Kotlin/collections/groupBy|groupBy]]</code>=== | ||
تجمِّع الدالة <code>groupBy()</code> عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت معها في مجموعات، إذ تطبق دالة محدَّدة على كل عنصر ثمَّ تعاد خريطة تحوي مجموعاتٍ مفتاحُ كلِّ واحدةٍ منها مرتبطٌ بقائمة من العناصر المقابلة. | |||
===<code>[[Kotlin/collections/groupByTo|groupByTo]]</code>=== | |||
=== <code>[[Kotlin/collections/ | تشبه الدالة <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/ | ===<code>[[Kotlin/collections/indexOf|indexOf]]</code>=== | ||
تجلب الدالة <code>indexOf()</code> فهرس أول ظهور لعنصر محدَّد من <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] أو القائمة التي استُدعيت معها. | |||
===<code>[[Kotlin/collections/indexOfFirst|indexOfFirst]]</code>=== | |||
=== <code>[[Kotlin/collections/ | تجلب الدالة <code>indexOfFirst()</code> فهرس أول عنصر يحقِّق شرطًا معيَّنًا من <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] أو القائمة التي استُدعيت معها. | ||
===<code>[[Kotlin/collections/indexOfLast|indexOfLast]]</code>=== | |||
تجلب الدالة <code>indexOfLast()</code> فهرس آخر عنصر يحقِّق شرطًا معيَّنًا من <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] أو القائمة التي استُدعيت معها. | |||
=== <code>[[Kotlin/collections/ | ===<code>[[Kotlin/collections/intersect|intersect]]</code>=== | ||
تبحث الدالة <code>intersect()</code> عن العناصر المشتركة بين مصفوفتين أو مجموعتين ثمَّ تعيدها في مجموعة. | |||
===<code>[[Kotlin/jvm/isArrayOf|isArrayOf]]</code>=== | |||
تتحقَّق الدالة <code>isArrayOf()</code> من حواية <nowiki/>[[Kotlin/Array|المصفوفة]] التي استُدعيت معها عناصرَ من نوعٍ محدَّد. | |||
===<code>[[Kotlin/collections/isEmpty|isEmpty]]</code>=== | |||
تتحقق الدالة <code>isEmpty()</code> إن كانت <nowiki/>[[Kotlin/Array|المصفوفة]] التي استُدعيت معها فارغةً أم لا. | |||
=== <code>[[Kotlin/collections/ | ===<code>[[Kotlin/collections/isNotEmpty|isNotEmpty]]</code>=== | ||
تتحقَّق الدالة <code>isNotEmpty()</code> إن كانت <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت معها فارغةً أم لا. | |||
===<code>[[Kotlin/collections/joinTo|joinTo]]</code>=== | |||
=== <code>[[Kotlin/collections/ | تضيف الدالة <code>joinTo()</code> بادئة ولاحقة إلى جميع عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت معها (أو جزءٍ منها) وتفصلها بفاصلة معينة ثمَّ تضيفها إلى سلسة نصية موجودة مسبقًا. | ||
===<code>[[Kotlin/collections/joinToString|joinToString]]</code>=== | |||
تضيف الدالة <code>joinToString()</code> بادئة ولاحقة إلى جميع عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت معها (أو جزءٍ منها) بعد فصل عناصرها بفاصلة معينة ثمَّ تضع الناتج في سلسة نصيةجديدة تنشئها آنذاك. | |||
=== <code>[[Kotlin/collections/ | ===<code>[[Kotlin/collections/last|last]]</code>=== | ||
تجلب الدالة <code>last()</code> آخر عنصر من عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت معها إن لم يمرر إليها أي شيء، أو آخر عنصر يحق شرطًا معيَّنًا في حال تمرير دالة منطقية إليها. | |||
===<code>[[Kotlin/collections/lastIndexOf|lastIndexOf]]</code>=== | |||
=== <code>[[Kotlin/collections/ | تجلب الدالة <code>lastIndexOf()</code> فهرس آخر ظهور لعنصر محدَّد من <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] أو القائمة التي استُدعيت معها. | ||
===<code>[[Kotlin/collections/lastOrNull|lastOrNull]]</code>=== | |||
تجلب الدالة <code>lastOrNull()</code> آخر عنصر من عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت معها إن لم يُمرَّر إليها أي شيء، أو آخر عنصر يحقق شرطًا معيَّنًا في حال تمرير دالة منطقية إليها. | |||
===<code>[[Kotlin/collections/map|map]]</code>=== | |||
تعيد الدالة <code>map()</code> قائمةً تحوي ناتج تطبيق الدالة المُمرّرة إليها على كل عنصر من عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] أو الخريطة التي استُدعيت معها. | |||
=== <code>[[Kotlin/collections/ | ===<code>[[Kotlin/collections/mapIndexed|mapIndexed]]</code>=== | ||
تعيد الدالة <code>mapIndexed()</code> قائمةً تحوي ناتج تطبيق الدالة المُمرّرة إليها على فهرس وقيمة كل عنصر من عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت معها. | |||
===<code>[[Kotlin/collections/mapIndexedNotNull|mapIndexedNotNull]]</code>=== | |||
=== <code>[[Kotlin/collections/ | تعيد الدالة <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/ | ===<code>[[Kotlin/collections/mapIndexedTo|mapIndexedTo]]</code>=== | ||
تشبه الدالة <code>mapIndexedTo()</code> الدالةَ <code>[[Kotlin/collections/mapIndexed|mapIndexed()]]</code> في جميع النواحي باستثناء أنها تضيف الناتج المعاد إلى المعامل الممرَّر إليها. | |||
===<code>[[Kotlin/collections/mapNotNull|mapNotNull]]</code>=== | |||
=== <code>[[Kotlin/collections/ | تعيد الدالة <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/ | ===<code>[[Kotlin/collections/mapTo|mapTo]]</code>=== | ||
تعيد الدالة <code> | تشبه الدالة <code>mapTo()</code> الدالة <code>[[Kotlin/collections/map|map()]]</code> باستثناء أنَّها تضيف الناتج المعاد إلى المعامل المُمرَّر إليها بدلًا من وضعه في قائمة. | ||
===<code>[[Kotlin/collections/max|max]]</code>=== | |||
=== <code>[[Kotlin/collections/ | تجلب الدالة <code>max()</code> أكبر عنصر في <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت معها. | ||
تعيد الدالة <code> | ===<code>[[Kotlin/collections/maxBy|maxBy]]</code>=== | ||
تجلب الدالة <code>maxBy()</code> العنصر أو الزوج الأول من <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] أو الخريطة التي استُدعيت معها والذي أعيدت معه أكبر قيمة عند تطبيق دالة معيَّنة عليه. | |||
=== <code>[[Kotlin/collections/ | ===<code>[[Kotlin/collections/maxWith|maxWith]]</code>=== | ||
تجلب الدالة <code>maxWith()</code> العنصر أو الزوج الأول من <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] أو الخريطة التي استُدعيت معها والذي له أكبر قيمة بحسب الموازن <code>comparator</code> المعطى. | |||
===<code>[[Kotlin/collections/min|min]]</code>=== | |||
=== <code>[[Kotlin/collections/ | تجلب الدالة <code>min()</code> أصغر عنصر في <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت معها. | ||
===<code>[[Kotlin/collections/minBy|minBy]]</code>=== | |||
تجلب الدالة <code>minBy()</code> العنصر أو الزوج الأول من <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] أو الخريطة التي استُدعيت معها والذي أعيدت معه أصغر قيمة عند تطبيق دالة معيَّنة عليه. | |||
=== <code>[[Kotlin/ | ===<code>[[Kotlin/collections/minWith|minWith]]</code>=== | ||
تجلب الدالة <code>minWith()</code> العنصر أو الزوج الأول من <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] أو الخريطة التي استُدعيت معها والذي له أصغر قيمة بحسب الموازن <code>comparator</code> المعطى. | |||
===<code>[[Kotlin/collections/none|none]]</code>=== | |||
=== <code>[[Kotlin/collections/ | تتحقَّق الدالة <code>none()</code> إن كانت <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] أو الخريطة التي استدعيت معها فارغةً، أو إن لم يكن هنالك أي عنصر من تلك العناصر محقِّقًا لشرط معين. | ||
===<code>[[Kotlin/collections/orEmpty|orEmpty]]</code>=== | |||
تعيد الدالة <code>orEmpty()</code> المصفوفة أو المجموعة أو القائمة أو الخريطة التي استُدعيت معها إن لم تكن مساويةً للقيمة <code>null</code>، أو تعيد كائنًا فارغًا يقابل الكائن المعطى (مصفوفة فارغة، أو مجموعة فارغة ...إلخ.) خلاف ذلك. | |||
=== <code>[[Kotlin/collections/ | ===<code>[[Kotlin/collections/partition|partition]]</code>=== | ||
تقسم الدالة <code>partition()</code> <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت معها إلى قسمين؛ الأول يضم العناصر التي تحقِّق شرطًا محدَّدًا، والثاني يضم العناصر الأخرى المتبقيَّة. | |||
===<code>[[Kotlin/collections/plus|plus]]</code>=== | |||
=== <code>[[Kotlin/collections/ | تضيف الدالة <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>reduce()</code> قيمة عنصر بدءًا من العنصر الأول عبر تطبيق عملية معينة من يسار العناصر المعطاة إلى يمينها على القيمة المتراكمة الحالية وعلى العنصر التالي ثم تُعيد قيمة العنصر النهائي الناتج. | |||
===<code>[[Kotlin/collections/reduceIndexed|reduceIndexed]]</code>=== | |||
=== <code>[[Kotlin/collections/ | تجمع الدالة <code>reduceIndexed()</code> ناتج تطبيق عملية معينة على قيمة كل عنصر من عناصر المصفوفة أو المجموعة (بدءًا من اليسار إلى اليمين) المستدعاة معها وفهرس ذلك العنصر بشكل تراكمي والقيمة المجمَّعة الحالية. | ||
===<code>[[Kotlin/collections/reduceRight|reduceRight]]</code>=== | |||
تجمع الدالة <code>reduceRight()</code> بشكل تراكمي ناتج تطبيق عملية معيَّنة على قيمة كل عنصر من عناصر المصفوفة أو المجموعة (بدءًا من اليمين إلى اليسار) المستدعاة معها والقيمة التراكمية الحالية. | |||
=== <code>[[Kotlin/collections/ | ===<code>[[Kotlin/collections/reduceRightIndexed|reduceRightIndexed]]</code>=== | ||
تجمع الدالة <code>reduceRightIndexed()</code> الناتج التراكمي لتطبيق عملية معينة على قيمة كل عنصر من عناصر المصفوفة أو المجموعة (بدءًا من اليمين إلى اليسار) المستدعاة معها وفهرس ذلك العنصر والقيمة المجمَّعة الحالية. | |||
===<code>[[Kotlin/collections/requireNoNulls|requireNoNulls]]</code>=== | |||
=== <code>[[Kotlin/collections/ | تعيد الدالة <code>requireNoNulls()</code> العناصر غير المعدومة (non-null) من <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] أو القائمة التي استُدعيت معها أو ترمي استثناءً إن وجد عنصر معدوم (null). | ||
===<code>[[Kotlin/collections/reverse|reverse]]</code>=== | |||
تعكس الدالة <code>reverse()</code> ترتيب عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو القائمة التي استُدعيت معها. | |||
=== <code>[[Kotlin/collections/ | ===<code>[[Kotlin/collections/reversed|reversed]]</code>=== | ||
تُعيد الدالة <code>reversed()</code> قائمة تضم عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت معها بترتيب معكوس. | |||
===<code>[[Kotlin/collections/reversedArray|reversedArray]]</code>=== | |||
=== <code>[[Kotlin/collections/ | تعيد الدالة <code>reversedArray()</code> <nowiki/>[[Kotlin/Array|مصفوفةً]] تضم عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] التي استُدعيت معها بترتيب معكوس. | ||
===<code>[[Kotlin/collections/single|single]]</code>=== | |||
تتحقَّق الدالة <code>single()</code> من حواية <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] أو القائمة التي استُدعيت معها عنصرًا واحدًا فقط أو عنصرًا واحدًا محققًا لشرط معيَّن ثمَّ تعيده أو تطلق <nowiki/>[[Kotlin/exceptions|استثناءً]] خلاف ذلك. | |||
=== <code>[[Kotlin/collections/ | ===<code>[[Kotlin/collections/singleOrNull|singleOrNull]]</code>=== | ||
تعيد | تتحقَّق الدالة <code>singleOrNull()</code> من حواية <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] أو القائمة التي استُدعيت معها عنصرًا واحدًا فقط، أو عنصرًا واحدًا محققًا لشرط معيَّن ثمَّ تعيده، أو تعيد القيمة <code>null</code>خلاف ذلك. | ||
===<code>[[Kotlin/collections/slice|slice]]</code>=== | |||
=== <code>[[Kotlin/collections/ | تقطع الدالة <code>slice()</code> جزءًا محدَّدًا من <nowiki/>[[Kotlin/Array|المصفوفة]] أو القائمة التي استُدعيت معها ثمَّ تعيده في قائمة. | ||
===<code>[[Kotlin/collections/sliceArray|sliceArray]]</code>=== | |||
تقطع الدالة <code>sliceArray()</code> جزءًا محدَّدًا من <nowiki/>[[Kotlin/Array|المصفوفة]] التي استُدعيت معها ثمَّ تعيده في مصفوفة أو قائمة بحسب الوسيط الممرر إليها. | |||
===<code>[[Kotlin/collections/sort|sort]] هنا</code>=== | |||
=== <code>[[Kotlin/collections/ | |||
=== <code>[[Kotlin/collections/ | |||
=== <code>[[Kotlin/collections/ | |||
=== <code>[[Kotlin/collections/ | |||
=== <code>[[Kotlin/collections/ | |||
=== <code>[[Kotlin/collections/ | |||
=== <code>[[Kotlin/collections/sort|sort]]</code> === | |||
تقوم الدالة<code>sort()</code> بترتيب <nowiki/>[[Kotlin/Array|المصفوفة]] أو اللائحة المتغيرة (<code>MutableList</code>) التي استُدعيت عبرها. | تقوم الدالة<code>sort()</code> بترتيب <nowiki/>[[Kotlin/Array|المصفوفة]] أو اللائحة المتغيرة (<code>MutableList</code>) التي استُدعيت عبرها. | ||
===<code>[[Kotlin/collections/sortBy|sortBy]]</code>=== | |||
=== <code>[[Kotlin/collections/sortBy|sortBy]]</code> === | |||
تقوم الدالة<code>sortBy()</code> بترتيب <nowiki/>[[Kotlin/Array|المصفوفة]] أو اللائحة المتغيرة (<code>MutableList</code>) التي استُدعيت عبرها وفقًا للقيم التي تعيدها الدالة المُمرّرة <code>selector</code> | تقوم الدالة<code>sortBy()</code> بترتيب <nowiki/>[[Kotlin/Array|المصفوفة]] أو اللائحة المتغيرة (<code>MutableList</code>) التي استُدعيت عبرها وفقًا للقيم التي تعيدها الدالة المُمرّرة <code>selector</code> | ||
===<code>[[Kotlin/collections/sortByDescending|sortByDescending]]</code>=== | |||
=== <code>[[Kotlin/collections/sortByDescending|sortByDescending]]</code> === | |||
تقوم الدالة<code>sortByDescending()</code> بترتيب <nowiki/>[[Kotlin/Array|المصفوفة]] أو اللائحة المتغيرة (<code>MutableList</code>) التي استُدعيت عبرها تنازليًا وفقًا للترتيب الطبيعي للقيم التي تعيدها الدالة المُمرّرة <code>selector</code>. | تقوم الدالة<code>sortByDescending()</code> بترتيب <nowiki/>[[Kotlin/Array|المصفوفة]] أو اللائحة المتغيرة (<code>MutableList</code>) التي استُدعيت عبرها تنازليًا وفقًا للترتيب الطبيعي للقيم التي تعيدها الدالة المُمرّرة <code>selector</code>. | ||
===<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|المصفوفة]] أو اللائحة المتغيرة (<code>MutableList</code>) التي استُدعيت عبرها تنازليًا. | ||
===<code>[[Kotlin/collections/sortWith|sortWith]]</code>=== | |||
=== <code>[[Kotlin/collections/sortWith|sortWith]]</code> === | |||
تقوم الدالة<code>sortWith()</code> بترتيب <nowiki/>[[Kotlin/Array|المصفوفة]] أو اللائحة المتغيرة (<code>MutableList</code>) التي استُدعيت عبرها تنازليًا وفقًا للمُقارن المُمرّر <code>comparator</code>. | تقوم الدالة<code>sortWith()</code> بترتيب <nowiki/>[[Kotlin/Array|المصفوفة]] أو اللائحة المتغيرة (<code>MutableList</code>) التي استُدعيت عبرها تنازليًا وفقًا للمُقارن المُمرّر <code>comparator</code>. | ||
===<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|مصفوفة]] تضم عناصر <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>[[Kotlin/collections/sortedArrayWith|sortedArrayWith]]</code> === | |||
تعيد الدالة<code>sortedArrayWith()</code> <nowiki/>[[Kotlin/Array|مصفوفة]] تضم عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] التي استُدعيت عبرها مرتبة وفق المُقارِن المُمرّر <code>comparator</code>. | تعيد الدالة<code>sortedArrayWith()</code> <nowiki/>[[Kotlin/Array|مصفوفة]] تضم عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] التي استُدعيت عبرها مرتبة وفق المُقارِن المُمرّر <code>comparator</code>. | ||
===<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|المصفوفة]] أو اللائحة المتغيرة (<code>MutableList</code>) التي استُدعيت عبرها مرتبة وفقًا للقيم التي تعيدها الدالة المُمرّرة <code>selector</code>. | ||
===<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|المصفوفة]] أو اللائحة المتغيرة (<code>MutableList</code>) التي استُدعيت عبرها مرتبة ترتيبًا تنازليًا وفقًا للقيم التي تعيدها الدالة المُمرّرة <code>selector</code>. | ||
===<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>comparator</code>. | ||
===<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>Set</code>) تضم عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو المجموعة التكرارية التي استُدعيت عبرها والتي لا توجد في <nowiki/>[[Kotlin/collections|المجموعة]] المُمرّرة. | ||
===<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> مجموع العناصر المُعادة من الدالة <code>selector</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> مجموع العناصر المُعادة من الدالة <code>selector</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>predicate</code>. | ||
===<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>predicate</code>. | ||
===<code>[[Kotlin/collections/toBooleanArray|toBooleanArray]]</code>=== | |||
=== <code>[[Kotlin/collections/toBooleanArray|toBooleanArray]]</code> === | |||
تعيد الدالة<code>toBooleanArray()</code> <nowiki/>[[Kotlin/Array|مصفوفة]] من القيم المنطقية (من النوع <code>BooleanArray</code>) تضم جميع عناصر <nowiki/>[[Kotlin/Array|المصفوفة العامة]] (أي من النوع<code>Array<out Boolean></code>) أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت عبرها. | تعيد الدالة<code>toBooleanArray()</code> <nowiki/>[[Kotlin/Array|مصفوفة]] من القيم المنطقية (من النوع <code>BooleanArray</code>) تضم جميع عناصر <nowiki/>[[Kotlin/Array|المصفوفة العامة]] (أي من النوع<code>Array<out Boolean></code>) أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت عبرها. | ||
===<code>[[Kotlin/collections/toByteArray|toByteArray]]</code>=== | |||
=== <code>[[Kotlin/collections/toByteArray|toByteArray]]</code> === | |||
تعيد الدالة<code>toByteArray()</code> <nowiki/>[[Kotlin/Array|مصفوفة]] من النوع <code>ByteArray</code>تضم جميع عناصر <nowiki/>[[Kotlin/Array|المصفوفة العامة]] (أي من النوع <code>Array<Byte></code>) أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت عبرها. | تعيد الدالة<code>toByteArray()</code> <nowiki/>[[Kotlin/Array|مصفوفة]] من النوع <code>ByteArray</code>تضم جميع عناصر <nowiki/>[[Kotlin/Array|المصفوفة العامة]] (أي من النوع <code>Array<Byte></code>) أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت عبرها. | ||
===<code>[[Kotlin/collections/toCharArray|toCharArray]]</code>=== | |||
=== <code>[[Kotlin/collections/toCharArray|toCharArray]]</code> === | |||
تعيد الدالة<code>toCharArray()</code> <nowiki/>[[Kotlin/Array|مصفوفة]] من النوع <code>CharArray</code>تضم جميع عناصر <nowiki/>[[Kotlin/Array|المصفوفة العامة]] (أي من النوع <code>Array<Char></code>) أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت عبرها. | تعيد الدالة<code>toCharArray()</code> <nowiki/>[[Kotlin/Array|مصفوفة]] من النوع <code>CharArray</code>تضم جميع عناصر <nowiki/>[[Kotlin/Array|المصفوفة العامة]] (أي من النوع <code>Array<Char></code>) أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت عبرها. | ||
===<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|المجموعة]] التي استُدعيت عبرها إلى المجموعة المتغيرة (<code>MutableCollection</code>) المُمرّرة<code>destination</code>. | ||
===<code>[[Kotlin/collections/toDoubleArray|toDoubleArray]]</code>=== | |||
=== <code>[[Kotlin/collections/toDoubleArray|toDoubleArray]]</code> === | |||
تعيد الدالة<code>toDoubleArray()</code> <nowiki/>[[Kotlin/Array|مصفوفة]] من النوع <code>DoubleArray</code>تضم جميع عناصر <nowiki/>[[Kotlin/Array|المصفوفة العامة]] (أي من النوع <code>Array<Double></code>) أو<nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت عبرها. | تعيد الدالة<code>toDoubleArray()</code> <nowiki/>[[Kotlin/Array|مصفوفة]] من النوع <code>DoubleArray</code>تضم جميع عناصر <nowiki/>[[Kotlin/Array|المصفوفة العامة]] (أي من النوع <code>Array<Double></code>) أو<nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت عبرها. | ||
===<code>[[Kotlin/collections/toFloatArray|toFloatArray]]</code>=== | |||
=== <code>[[Kotlin/collections/toFloatArray|toFloatArray]]</code> === | |||
تعيد الدالة<code>toFloatArray()</code> <nowiki/>[[Kotlin/Array|مصفوفة]] من النوع <code>FloatArray</code>تضم جميع عناصر <nowiki/>[[Kotlin/Array|المصفوفة العامة]] (أي من النوع <code>Array<Float></code>) أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت عبرها. | تعيد الدالة<code>toFloatArray()</code> <nowiki/>[[Kotlin/Array|مصفوفة]] من النوع <code>FloatArray</code>تضم جميع عناصر <nowiki/>[[Kotlin/Array|المصفوفة العامة]] (أي من النوع <code>Array<Float></code>) أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت عبرها. | ||
===<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>[[Kotlin/collections/toIntArray|toIntArray]]</code> === | |||
تعيد الدالة<code>toIntArray()</code> <nowiki/>[[Kotlin/Array|مصفوفة]] من النوع <code>IntArray</code>تضم جميع عناصر <nowiki/>[[Kotlin/Array|المصفوفة العامة]] (أي من النوع <code>Array<Int></code>) أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت عبرها. | تعيد الدالة<code>toIntArray()</code> <nowiki/>[[Kotlin/Array|مصفوفة]] من النوع <code>IntArray</code>تضم جميع عناصر <nowiki/>[[Kotlin/Array|المصفوفة العامة]] (أي من النوع <code>Array<Int></code>) أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت عبرها. | ||
===<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>toList()</code> عبر قاموسفستعيد لائحة تضم جميع الأزواج مفتاح/قيمة المنتمية إليه. | ||
===<code>[[Kotlin/collections/toLongArray|toLongArray]]</code>=== | |||
=== <code>[[Kotlin/collections/toLongArray|toLongArray]]</code> === | |||
تعيد الدالة<code>toLongArray()</code> <nowiki/>[[Kotlin/Array|مصفوفة]] من النوع <code>LongArray</code>تضم جميع عناصر <nowiki/>[[Kotlin/Array|المصفوفة العامة]] (أي من النوع <code>Array<Long></code>) أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت عبرها. | تعيد الدالة<code>toLongArray()</code> <nowiki/>[[Kotlin/Array|مصفوفة]] من النوع <code>LongArray</code>تضم جميع عناصر <nowiki/>[[Kotlin/Array|المصفوفة العامة]] (أي من النوع <code>Array<Long></code>) أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت عبرها. | ||
===<code>[[Kotlin/collections/toMap|toMap]]</code>=== | |||
=== <code>[[Kotlin/collections/toMap|toMap]]</code> === | |||
تعيد الدالة<code>toMap()</code> قاموسًا بحسب نوع إمضاء الدالة (انظر فقرة ا<nowiki/>[[Kotlin/collections/toMap#.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>toMap()</code> قاموسًا بحسب نوع إمضاء الدالة (انظر فقرة ا<nowiki/>[[Kotlin/collections/toMap#.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>[[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> مجموعة من النوع <code>MutableSet</code> تضم جميع عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو المجموعة التكرارية التي استُدعيت عبرها بدون تكرار. | ||
===<code>[[Kotlin/collections/toSet|toSet]]</code>=== | |||
=== <code>[[Kotlin/collections/toSet|toSet]]</code> === | |||
تعيد الدالة<code>toSet()</code> مجموعة من النوع <code>Set</code> تضم جميع عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو المجموعة التكرارية التي استُدعيت عبرها. | تعيد الدالة<code>toSet()</code> مجموعة من النوع <code>Set</code> تضم جميع عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو المجموعة التكرارية التي استُدعيت عبرها. | ||
===<code>[[Kotlin/collections/toShortArray|toShortArray]]</code>=== | |||
=== <code>[[Kotlin/collections/toShortArray|toShortArray]]</code> === | |||
تعيد الدالة<code>toShortArray()</code> <nowiki/>[[Kotlin/Array|مصفوفة]] من النوع <code>ShortArray</code>تضم جميع عناصر <nowiki/>[[Kotlin/Array|المصفوفة العامة]] (أي من النوع <code>Array<Short></code>) أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت عبرها. | تعيد الدالة<code>toShortArray()</code> <nowiki/>[[Kotlin/Array|مصفوفة]] من النوع <code>ShortArray</code>تضم جميع عناصر <nowiki/>[[Kotlin/Array|المصفوفة العامة]] (أي من النوع <code>Array<Short></code>) أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت عبرها. | ||
===<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> مجموعة من النوع <code>SortedSet</code> تضم جميع عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو المجموعة التكرارية التي استُدعيت عبرها. وفي حال تمرير دالة مقارنة <code>comparator</code> إلى الدالة<code>toSortedSet()</code> فسترتب المجموعة المعادة حسب ذلك المقارِن. | ||
===<code>[[Kotlin/collections/union|union]]</code>=== | |||
=== <code>[[Kotlin/collections/union|union]]</code> === | |||
تعيد الدالة<code>union()</code> مجموعة من النوع Set تضم جميع عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو المجموعة التكرارية التي استُدعيت عبرها والمجموعة التكرارية المُمرّرة. | تعيد الدالة<code>union()</code> مجموعة من النوع Set تضم جميع عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو المجموعة التكرارية التي استُدعيت عبرها والمجموعة التكرارية المُمرّرة. | ||
===<code>[[Kotlin/collections/unzip|unzip]]</code>=== | |||
=== <code>[[Kotlin/collections/unzip|unzip]]</code> === | |||
تعيد الدالة<code>unzip()</code> زوجًا مكونًا من لائحتين، حيث اللائحة الأولي مكونة من العناصر الأولى من كل زوج من <nowiki/>[[Kotlin/Array|المصفوفة]] أو المجموعة التكرارية التي استُدعيت عبرها، واللائحة الثانية مكونة من العناصر الثانية من كل زوج من <nowiki/>[[Kotlin/Array|المصفوفة]] أو المجموعة التكرارية التي استُدعيت عبرها. | تعيد الدالة<code>unzip()</code> زوجًا مكونًا من لائحتين، حيث اللائحة الأولي مكونة من العناصر الأولى من كل زوج من <nowiki/>[[Kotlin/Array|المصفوفة]] أو المجموعة التكرارية التي استُدعيت عبرها، واللائحة الثانية مكونة من العناصر الثانية من كل زوج من <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|مُكرّر]] (<code>Iterator</code>) فستعيد <nowiki/>[[Kotlin/iterator|مُكرّر]]<nowiki/>ا يغلّف كل عنصر مُنتج من ذلك <nowiki/>[[Kotlin/iterator|المكرّر]] مع القيمة المُفهرسة. | ||
===<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/-array/index.html صفحة الصنف Array في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.] | |||
[[تصنيف:Kotlin]] | [[تصنيف:Kotlin]] | ||
[[تصنيف:Kotlin Classes]] | [[تصنيف:Kotlin Classes]] | ||
[[تصنيف:Kotlin Array]] | [[تصنيف:Kotlin Array]] | ||
مراجعة 11:00، 8 سبتمبر 2018
يمثل الصنف Array مصفوفة (مصفوفة Java تحديدًا عند استهداف المنصة JVM). يمكن إنشاء نسخ من هذا الصنف باستعمال الدوال ()arrayOf و ()arrayOfNulls و ()emptyArray الخاصة بالمكتبة القياسية. للمزيد من المعلومات حول المصفوفات، ارجع إلى قسم "المصفوفات" في توثيق الأنواع الأساسية.
class Array<T>
الدوال البانية
<int>
تنشِئ الدالة Array() البانية مصفوفةً بحجم size مُحدَّدٍ، حيث يُحسَب كلُّ عنصرٍ فيها عبر استدعاء الدالة init المُحدَّدة، والتي تُعيد عنصرًا في المصفوفة بحسب الفهرس (index) المُعطى.
الدوال والخاصيات
size
تمثِّل الخاصيّة size عدد العناصر الموجودة في المصفوفة (array).
iterator
تعيد هذه الدالة عنصرًا تكراريًّا (iterator) بهدف تطبيق حلقة تكرار (loop) برمجيةٍ على كافّة عناصر المصفوفة.
get
تعيد هذه الدالة قيمة عنصر محدد بعد تمرير فهرسه (index) إليه.
الدوال الموروثة
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) التي استُدعيت عبرها وفقًا للقيم التي تعيدها الدالة المُمرّرة selector
sortByDescending
تقوم الدالةsortByDescending() بترتيب المصفوفة أو اللائحة المتغيرة (MutableList) التي استُدعيت عبرها تنازليًا وفقًا للترتيب الطبيعي للقيم التي تعيدها الدالة المُمرّرة selector.
sortDescending
تقوم الدالةsortDescending() بترتيب المصفوفة أو اللائحة المتغيرة (MutableList) التي استُدعيت عبرها تنازليًا.
sortWith
تقوم الدالةsortWith() بترتيب المصفوفة أو اللائحة المتغيرة (MutableList) التي استُدعيت عبرها تنازليًا وفقًا للمُقارن المُمرّر comparator.
sorted
تعيد الدالةsorted() لائحة تضم عناصر المصفوفة أو المجموعة التكرارية التي استُدعيت عبرها مرتبة وفق الترتيب الطبيعي.
sortedArray
تعيد الدالةsortedArray() مصفوفة تضم عناصر المصفوفة التي استُدعيت عبرها مرتبة وفق الترتيب الطبيعي.
sortedArrayDescending
تعيد الدالةsortedArrayDescending() مصفوفة تضم عناصر المصفوفة التي استُدعيت عبرها مرتبة ترتيبًا تنازليًا.
sortedArrayWith
تعيد الدالةsortedArrayWith() مصفوفة تضم عناصر المصفوفة التي استُدعيت عبرها مرتبة وفق المُقارِن المُمرّر comparator.
sortedBy
تعيد الدالةsortedBy() لائحة تضم عناصر المصفوفة أو اللائحة المتغيرة (MutableList) التي استُدعيت عبرها مرتبة وفقًا للقيم التي تعيدها الدالة المُمرّرة selector.
sortedByDescending
تعيد الدالةsortedByDescending() لائحة تضم عناصر المصفوفة أو اللائحة المتغيرة (MutableList) التي استُدعيت عبرها مرتبة ترتيبًا تنازليًا وفقًا للقيم التي تعيدها الدالة المُمرّرة selector.
sortedDescending
تعيد الدالةsortedDescending() لائحة تضم عناصر المصفوفة أو المجموعة التكرارية التي استُدعيت عبرها مرتبة تنازليًا.
sortedWith
تعيد الدالةsortedWith() لائحة تضم عناصر المصفوفة أو المجموعة التكرارية التي استُدعيت عبرها مرتبة وفق المُقارِن المُمرّر comparator.
subtract
تعيد الدالةsubtract() مجموعة (Set) تضم عناصر المصفوفة أو المجموعة التكرارية التي استُدعيت عبرها والتي لا توجد في المجموعة المُمرّرة.
sum
تعيد الدالةsum() مجموع عناصر المصفوفة أو المجموعة التي استُدعيت عبرها.
sumBy
تعيد الدالةsumBy() مجموع العناصر المُعادة من الدالة selector مطبقةً على عناصر المصفوفة أو المجموعة التي استُدعيت عبرها.
sumByDouble
تعيد الدالةsumByDouble() مجموع العناصر المُعادة من الدالة selector مطبقةً على عناصر المصفوفة أو المجموعة التي استُدعيت عبرها.
take
تعيد الدالةtake() لائحة تضم n من أولى العناصر الموجودة في المصفوفة أو المجموعة التكرارية التي استُدعيت عبرها.
takeLast
تعيد الدالةtakeLast() لائحة تضم آخر n من العناصر الموجودة في المصفوفة أو المجموعة التكرارية التي استُدعيت عبرها.
takeLastWhile
تعيد الدالةtakeLastWhile() لائحة تضم آخر عناصر المصفوفة أو اللائحة التي استُدعيت عبرها والتي تحقق الشرط المنطقي المُمرّر predicate.
takeWhile
تعيد الدالةtakeWhile() لائحة تضم أولى عناصر المصفوفة أو المجموعة التكرارية التي استُدعيت عبرها والتي تحقق الشرط المنطقي المُمرّرpredicate.
toBooleanArray
تعيد الدالةtoBooleanArray() مصفوفة من القيم المنطقية (من النوع BooleanArray) تضم جميع عناصر المصفوفة العامة (أي من النوعArray<out Boolean>) أو المجموعة التي استُدعيت عبرها.
toByteArray
تعيد الدالةtoByteArray() مصفوفة من النوع ByteArrayتضم جميع عناصر المصفوفة العامة (أي من النوع Array<Byte>) أو المجموعة التي استُدعيت عبرها.
toCharArray
تعيد الدالةtoCharArray() مصفوفة من النوع CharArrayتضم جميع عناصر المصفوفة العامة (أي من النوع Array<Char>) أو المجموعة التي استُدعيت عبرها.
toCollection
تضيف الدالةtoCollection() عناصر المصفوفة أو المجموعة التي استُدعيت عبرها إلى المجموعة المتغيرة (MutableCollection) المُمرّرةdestination.
toDoubleArray
تعيد الدالةtoDoubleArray() مصفوفة من النوع DoubleArrayتضم جميع عناصر المصفوفة العامة (أي من النوع Array<Double>) أوالمجموعة التي استُدعيت عبرها.
toFloatArray
تعيد الدالةtoFloatArray() مصفوفة من النوع FloatArrayتضم جميع عناصر المصفوفة العامة (أي من النوع Array<Float>) أو المجموعة التي استُدعيت عبرها.
toHashSet
تعيد الدالةtoHashSet() كائنًا من النوع HashSetيضم جميع عناصر المصفوفة أو المجموعة التي استُدعيت عبرها.
toIntArray
تعيد الدالةtoIntArray() مصفوفة من النوع IntArrayتضم جميع عناصر المصفوفة العامة (أي من النوع Array<Int>) أو المجموعة التي استُدعيت عبرها.
toList
تعيد الدالةtoList() لائحة تضم جميع عناصر المصفوفة أو المجموعة التكرارية التي استُدعيت عبرها. وفي حال استدعاء الدالةtoList() عبر قاموسفستعيد لائحة تضم جميع الأزواج مفتاح/قيمة المنتمية إليه.
toLongArray
تعيد الدالةtoLongArray() مصفوفة من النوع LongArrayتضم جميع عناصر المصفوفة العامة (أي من النوع Array<Long>) أو المجموعة التي استُدعيت عبرها.
toMap
تعيد الدالةtoMap() قاموسًا بحسب نوع إمضاء الدالة (انظر فقرة البنية العامة من أجل التفاصيل).
toMutableList
تعيد الدالةtoMutableList() لائحة متغيرة تضم جميع عناصر المصفوف أو المجموعة التي استُدعيت عبرها.
toMutableSet
تعيد الدالةtoMutableSet() مجموعة من النوع MutableSet تضم جميع عناصر المصفوفة أو المجموعة التكرارية التي استُدعيت عبرها بدون تكرار.
toSet
تعيد الدالةtoSet() مجموعة من النوع Set تضم جميع عناصر المصفوفة أو المجموعة التكرارية التي استُدعيت عبرها.
toShortArray
تعيد الدالةtoShortArray() مصفوفة من النوع ShortArrayتضم جميع عناصر المصفوفة العامة (أي من النوع Array<Short>) أو المجموعة التي استُدعيت عبرها.
toSortedSet
تعيد الدالةtoSortedSet() مجموعة من النوع SortedSet تضم جميع عناصر المصفوفة أو المجموعة التكرارية التي استُدعيت عبرها. وفي حال تمرير دالة مقارنة comparator إلى الدالةtoSortedSet() فسترتب المجموعة المعادة حسب ذلك المقارِن.
union
تعيد الدالةunion() مجموعة من النوع Set تضم جميع عناصر المصفوفة أو المجموعة التكرارية التي استُدعيت عبرها والمجموعة التكرارية المُمرّرة.
unzip
تعيد الدالةunzip() زوجًا مكونًا من لائحتين، حيث اللائحة الأولي مكونة من العناصر الأولى من كل زوج من المصفوفة أو المجموعة التكرارية التي استُدعيت عبرها، واللائحة الثانية مكونة من العناصر الثانية من كل زوج من المصفوفة أو المجموعة التكرارية التي استُدعيت عبرها.
withIndex
تعيد الدالةwithIndex() مجموعة تكرارية خاملة (lazy Iterable) من القيم المُفهرسة لكل عنصر من عناصر المصفوفة أو المجموعة التكرارية التي استُدعيت عبرها، وفي حال استدعائها عبر مُكرّر (Iterator) فستعيد مُكرّرا يغلّف كل عنصر مُنتج من ذلك المكرّر مع القيمة المُفهرسة.
zip
يختلف سلوك الدالةzip() بحسب إمضائها، أنظر فقرة البنية العامة لأجل التفاصيل.