الفرق بين المراجعتين لصفحة: «Kotlin/kotlin.text/MatchGroupCollection»
< Kotlin | kotlin.text
لا ملخص تعديل |
جميل-بيلوني (نقاش | مساهمات) طلا ملخص تعديل |
||
| (9 مراجعات متوسطة بواسطة مستخدمين اثنين آخرين غير معروضة) | |||
| سطر 1: | سطر 1: | ||
تمثل <code>MatchGroupCollection</code> | <noinclude>{{DISPLAYTITLE: الواجهة <code>MatchGroupCollection</code> في Kotlin}}</noinclude> | ||
تمثل الواجهة <code>MatchGroupCollection</code> مجموعةً (collection) من الفئات المرصودة (captured groups) عند إجراء مطابقة واحدة [[Kotlin/kotlin.text/Regex/index|لتعبير نمطي]] ما. | |||
حجم المجموعة يساوي <code>groupCount + 1</code> | حجم المجموعة يساوي <code>groupCount + 1</code>، إذ يمثل <code>groupCount</code> عدد الفئات (groups) في [[Kotlin/kotlin.text/Regex/index|التعبير النمطي]]. الفئات مُفهرسة بدءًا من 1 وحتى <code>groupCount</code>، والفئة ذات الفهرس 0 تقابل كل ما تطابق. | ||
يمكن أن يساوي بعض عناصر المجموعة القيمة العدمية (null) في حال كانت الفئة المقابلة في [[Kotlin/kotlin.text/Regex/index|التعبير النمطي]] اختيارية، ولم يُرصَد أي تطابق من قبل تلك الفئة.<syntaxhighlight lang="kotlin"> | |||
interface MatchGroupCollection : Collection<MatchGroup?> | |||
</syntaxhighlight> | |||
==الدوال== | |||
===<code>[[Kotlin/kotlin.text/MatchGroupCollection/get|get]]</code>=== | |||
تعيد هذه الدالة نسخةً من الصنف <code>[[Kotlin/kotlin.text/MatchResult/index|MatchGroup]]</code> إن كانت المجموعة التي تحمل الاسم المُمرّر إليها متطابقَة. | |||
==الوارثات (Inheritors) == | |||
===<code>[[Kotlin/kotlin.text/MatchNamedGroupCollection/index|MatchNamedGroupCollection]]</code>=== | |||
توسِّع هذه الواجهة الصنف <code>MatchGroupCollection</code> عبر تعريف طريقةٍ لجلب المجموعات المتطابقة (matched groups) عن طريق أسمائها عندما يدعم <code>regex</code> ذلك. | |||
==الخاصيات الإضافية (Extension Properties)== | ==الخاصيات الإضافية (Extension Properties)== | ||
===<code>[[Kotlin/collections/indices|indices]]</code>=== | ===<code>[[Kotlin/collections/indices|indices]]</code>=== | ||
تُستخدَم هذه الخاصيّة للحصول على الفهارس الصحيحة (valid indices) للمصفوفة أو المجموعة (collection). | تُستخدَم هذه الخاصيّة للحصول على الفهارس الصحيحة (valid indices) للمصفوفة أو المجموعة (collection). | ||
==الدوال الإضافية (Extension Functions)== | ==الدوال الإضافية (Extension Functions)== | ||
===<code>[[Kotlin/collections/all|all]]</code>=== | ===<code>[[Kotlin/collections/all|all]]</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/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> | تعيد الدالة <code>associate()</code> خريطةً (map) تحوي أزواجًا من "مفتاح/قيمة" ناتجة عن تمرير عناصر المصفوفة أو المجموعة ([[Kotlin/collections|Collection]]) إلى الدالة المررة إليها. | ||
===<code>[[Kotlin/collections/associateBy|associateBy]]</code>=== | ===<code>[[Kotlin/collections/associateBy|associateBy]]</code>=== | ||
تعيد الدالة <code>associateBy()</code> خريطةً (map) | تعيد الدالة <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> الدالة <code>[[Kotlin/collections/associateBy|associateBy()]]</code> تمامًا باستثناء أنها تضيف الناتج الذي تعيده إلى خريطة موجودة مسبقًا. | |||
===<code>[[Kotlin/collections/associateTo|associateTo]]</code>=== | ===<code>[[Kotlin/collections/associateTo|associateTo]]</code>=== | ||
تشبه الدالة <code>associateTo()</code> الدالة <code>[[Kotlin/collections/associate|associate()]]</code> تمامًا باستثناء أنها تضيف الناتج الذي تعيده إلى خريطة موجودة مسبقًا. | |||
===<code>[[Kotlin/collections/chunked|chunked]]</code>=== | |||
===<code>[[Kotlin/collections/ | |||
===<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/ | ===<code>[[Kotlin/collections/containsAll|containsAll]]</code>=== | ||
===<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/dropWhile|dropWhile]]</code>=== | ===<code>[[Kotlin/collections/dropWhile|dropWhile]]</code>=== | ||
تعيد | تعيد الدالة <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|المجموعة]] التي استُدعيت معها. | تجلب الدالة <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|المجموعة]] التي استُدعيت معها. إن كان الفهرس المعطى خارج | تجلب الدالة <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> العنصر الموجود عند الفهرس (index) المحدد من <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/Array|المجموعة]] التي استُدعيت عبرها، وفي حال كان ذلك الفهرس خارج حدود <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/Array|المجموعة]] فستُعيد القيمة المعدومة <code>null</code>. | |||
===<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>filterIndexed()</code> عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] المعطاة بناءً على فهرس العنصر وقيمته. | ||
===<code>[[Kotlin/collections/filterIndexedTo|filterIndexedTo]]</code>=== | ===<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/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>[[Kotlin/collections/filterNot|filterNot()]]</code> في جميع النواحي باستثناء أنَّها تضيف الناتج المعاد إلى المعامل الممرَّر إليها. | |||
===<code>[[Kotlin/collections/filterTo|filterTo]]</code>=== | ===<code>[[Kotlin/collections/filterTo|filterTo]]</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>[[Kotlin/collections/findLast|findLast]]</code>=== | ===<code>[[Kotlin/collections/findLast|findLast]]</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>[[Kotlin/collections/firstOrNull|firstOrNull]]</code>=== | ===<code>[[Kotlin/collections/firstOrNull|firstOrNull]]</code>=== | ||
تجلب الدالة <code>firstOrNull()</code> أول عنصر من عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت معها إن لم يُمرَّر إليها أي شيء، أو أول عنصر يحقق شرطًا معيَّنًا في حال تمرير دالة منطقية إليها. | |||
===<code>[[Kotlin/collections/flatMap|flatMap]]</code>=== | ===<code>[[Kotlin/collections/flatMap|flatMap]]</code>=== | ||
تعيد | تعيد الدالة <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>[[Kotlin/collections/flatMap|flatMap()]]</code> تمامًا باستثناء أنها تضيف الناتج المعاد إلى كائن موجود مسبقًا بدلًا من إعادته فقط. | |||
===<code>[[Kotlin/collections/fold|fold]]</code>=== | ===<code>[[Kotlin/collections/fold|fold]]</code>=== | ||
تجمع الدالة <code>fold()</code> تراكميًّا ناتج تطبيق عملية معينة على قيمة كل عنصر من عناصر الكائن المستدعى معها والقيمة التراكمية الحالية بالإضافة إلى قيمة أولية إن أعطيت. | |||
===<code>[[Kotlin/collections/foldIndexed|foldIndexed]]</code>=== | ===<code>[[Kotlin/collections/foldIndexed|foldIndexed]]</code>=== | ||
تجمع الدالة <code>foldIndexed()</code> ناتج تطبيق عملية معينة على قيمة كل عنصر من عناصر المصفوفة أو المجموعة (بدءًا من اليسار إلى اليمين) المستدعاة معها وفهرس ذلك العنصر بشكل تراكمي بالإضافة إلى القيمة الأولية إن أعطيت. | |||
===<code>[[Kotlin/collections/forEach|forEach]]</code>=== | ===<code>[[Kotlin/collections/forEach|forEach]]</code>=== | ||
تُنفّد | تُنفّد الدالةُ <code>forEach()</code> الدالةَ المُمرّرةَ إليها على كل عنصر من عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] أو الخريطة التي استُدعيت معها. | ||
===<code>[[Kotlin/collections/forEachIndexed|forEachIndexed]]</code>=== | ===<code>[[Kotlin/collections/forEachIndexed|forEachIndexed]]</code>=== | ||
تُنفّد | تُنفّد الدالةُ <code>forEachIndexed()</code> الدالةَ المُمرّرةَ إليها على كل عنصر من عناصر <nowiki/>[[Kotlin/Array|المصفوفة]]، أو <nowiki/>[[Kotlin/collections|المجموعة]]، أو الخريطة، التي استُدعيت معها وعلى فهرس ذلك العنصر. | ||
===<code>[[Kotlin/collections/groupBy|groupBy]]</code>=== | ===<code>[[Kotlin/collections/groupBy|groupBy]]</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> الدالة <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>[[Kotlin/collections/indexOfFirst|indexOfFirst]]</code>=== | ===<code>[[Kotlin/collections/indexOfFirst|indexOfFirst]]</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>[[Kotlin/collections/intersect|intersect]]</code>=== | ===<code>[[Kotlin/collections/intersect|intersect]]</code>=== | ||
تبحث الدالة <code>intersect()</code> عن العناصر المشتركة بين مصفوفتين أو مجموعتين ثمَّ تعيدها في مجموعة. | |||
===<code>[[Kotlin/collections/isNotEmpty|isNotEmpty]]</code>=== | ===<code>[[Kotlin/collections/isNotEmpty|isNotEmpty]]</code>=== | ||
تتحقَّق الدالة <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>[[Kotlin/collections/joinToString|joinToString]]</code>=== | ===<code>[[Kotlin/collections/joinToString|joinToString]]</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>[[Kotlin/collections/lastIndexOf|lastIndexOf]]</code>=== | ===<code>[[Kotlin/collections/lastIndexOf|lastIndexOf]]</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>[[Kotlin/collections/map|map]]</code>=== | ===<code>[[Kotlin/collections/map|map]]</code>=== | ||
تعيد | تعيد الدالة <code>map()</code> قائمةً تحوي ناتج تطبيق الدالة المُمرّرة إليها على كل عنصر من عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] أو الخريطة التي استُدعيت معها. | ||
===<code>[[Kotlin/collections/mapIndexed|mapIndexed]]</code>=== | ===<code>[[Kotlin/collections/mapIndexed|mapIndexed]]</code>=== | ||
تعيد | تعيد الدالة <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>[[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>[[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>[[Kotlin/collections/maxBy|maxBy]]</code>=== | ===<code>[[Kotlin/collections/maxBy|maxBy]]</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>[[Kotlin/collections/min|min]]</code>=== | ===<code>[[Kotlin/collections/min|min]]</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>[[Kotlin/collections/minWith|minWith]]</code>=== | ===<code>[[Kotlin/collections/minWith|minWith]]</code>=== | ||
تجلب الدالة <code>minWith()</code> العنصر أو الزوج الأول من <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] أو الخريطة التي استُدعيت معها والذي له أصغر قيمة بحسب الموازن <code>comparator</code> المعطى. | |||
===<code>[[Kotlin/collections/minus|minus]]</code>=== | |||
===<code>[[Kotlin/collections/minusElement|minusElement]]</code>=== | |||
===<code>[[Kotlin/collections/none|none]]</code>=== | ===<code>[[Kotlin/collections/none|none]]</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>[[Kotlin/collections/plus|plus]]</code>=== | ===<code>[[Kotlin/collections/plus|plus]]</code>=== | ||
تضيف الدالة <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> قيمة عنصر بدءًا من العنصر الأول عبر تطبيق عملية معينة من يسار العناصر المعطاة إلى يمينها على القيمة المتراكمة الحالية وعلى العنصر التالي ثم تُعيد قيمة العنصر النهائي الناتج. | |||
===<code>[[Kotlin/collections/reduceIndexed|reduceIndexed]]</code>=== | ===<code>[[Kotlin/collections/reduceIndexed|reduceIndexed]]</code>=== | ||
تجمع الدالة <code>reduceIndexed()</code> ناتج تطبيق عملية معينة على قيمة كل عنصر من عناصر المصفوفة أو المجموعة (بدءًا من اليسار إلى اليمين) المستدعاة معها وفهرس ذلك العنصر بشكل تراكمي والقيمة المجمَّعة الحالية. | |||
===<code>[[Kotlin/collections/ | ===<code>[[Kotlin/collections/requireNoNulls|requireNoNulls]]</code>=== | ||
تعيد الدالة <code>requireNoNulls()</code> العناصر غير المعدومة (non-null) من <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] أو القائمة التي استُدعيت معها أو ترمي استثناءً إن وجد عنصر معدوم (null). | |||
===<code>[[Kotlin/collections/reversed|reversed]]</code>=== | ===<code>[[Kotlin/collections/reversed|reversed]]</code>=== | ||
تُعيد | تُعيد الدالة <code>reversed()</code> قائمة تضم عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت معها بترتيب معكوس. | ||
===<code>[[Kotlin/collections/ | ===<code>[[Kotlin/collections/shuffled|shuffled]]</code>=== | ||
===<code>[[Kotlin/collections/single|single]]</code>=== | ===<code>[[Kotlin/collections/single|single]]</code>=== | ||
تتحقَّق الدالة <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>null</code>خلاف ذلك. | |||
===<code>[[Kotlin/collections/sorted|sorted]]</code>=== | ===<code>[[Kotlin/collections/sorted|sorted]]</code>=== | ||
ترتِّب الدالة <code>sorted()</code> جميع عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو المجموعة التكرارية التي استُدعيت معها تصاعديًّا ثمَّ تضع الناتج في قائمة. | |||
===<code>[[Kotlin/collections/sortedBy|sortedBy]]</code>=== | ===<code>[[Kotlin/collections/sortedBy|sortedBy]]</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|المصفوفة]] أو المجموعة التكرارية (Iterable) التي استُدعيت معها تنازليًّا وفقًا للقيم التي تعيدها الدالة المُمرّرة إليها عند تطبيقها على كل عنصر ثمَّ تضع الناتج في قائمة. | |||
===<code>[[Kotlin/collections/sortedDescending|sortedDescending]]</code>=== | ===<code>[[Kotlin/collections/sortedDescending|sortedDescending]]</code>=== | ||
ترتِّب الدالة <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>[[Kotlin/collections/subtract|subtract]]</code>=== | ===<code>[[Kotlin/collections/subtract|subtract]]</code>=== | ||
تستثني الدالة <code>subtract()</code> العناصر المشتركة بين كائنين. | |||
===<code>[[Kotlin/collections/sumBy|sumBy]]</code>=== | ===<code>[[Kotlin/collections/sumBy|sumBy]]</code>=== | ||
تجمع الدالة <code>sumBy()</code> جميع نواتج تطبيق دالة معيَّنة على كل عنصر من عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت معها. | |||
===<code>[[Kotlin/collections/sumByDouble|sumByDouble]]</code>=== | ===<code>[[Kotlin/collections/sumByDouble|sumByDouble]]</code>=== | ||
تجمع الدالة <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>[[Kotlin/collections/takeWhile|takeWhile]]</code>=== | ===<code>[[Kotlin/collections/takeWhile|takeWhile]]</code>=== | ||
تجلب الدالة <code>takeWhile()</code> أول عناصر محققة لشرطٍ محدَّدٍ من <nowiki/>[[Kotlin/Array|المصفوفة]] أو القائمة التي استُدعيت معها. | |||
===<code>[[Kotlin/collections/toCollection|toCollection]]</code>=== | ===<code>[[Kotlin/collections/toCollection|toCollection]]</code>=== | ||
تضيف | تضيف الدالة <code>toCollection()</code> جميع عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت معها إلى المجموعة المتغيرة (MutableCollection) المُمرّرة إليها. | ||
===<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>[[Kotlin/collections/toList|toList]]</code>=== | ===<code>[[Kotlin/collections/toList|toList]]</code>=== | ||
تحول الدالة <code>toList()</code> <nowiki/>[[Kotlin/Array|المصفوفة]] أو المجموعة التكرارية أو الخريطة التي استُدعيت معها إلى قائمة. | |||
===<code>[[Kotlin/collections/toMutableSet|toMutableSet]]</code>=== | ===<code>[[Kotlin/collections/toMutableSet|toMutableSet]]</code>=== | ||
تحول الدالة <code>toMutableSet()</code> <nowiki/>[[Kotlin/Array|المصفوفة]] أو المجموعة التكرارية التي استُدعيت معها إلى مجموعة من النوع <code>MutableSet</code>؛ تحافظ المجموعة المُعادة على نفس ترتيب تكرار المصفوفة أو المجموعة التكرارية الأصلية. | |||
===<code>[[Kotlin/collections/toSet|toSet]]</code>=== | ===<code>[[Kotlin/collections/toSet|toSet]]</code>=== | ||
تحول الدالة <code>toSet()</code> <nowiki/>[[Kotlin/Array|المصفوفة]] أو المجموعة التكرارية التي استُدعيت معها إلى مجموعة من النوع <code>Set</code>. تحافظ المجموعة المُعادة على نفس ترتيب تكرار المصفوفة أو المجموعة التكرارية الأصلية. | |||
===<code>[[Kotlin/collections/ | ===<code>[[Kotlin/collections/toTypedArray|toTypedArray]]</code>=== | ||
===<code>[[Kotlin/collections/union|union]]</code>=== | ===<code>[[Kotlin/collections/union|union]]</code>=== | ||
تعيد | تجمع الدالة <code>union()</code> العناصر المشتركة وغير المتشركة بين <nowiki/>[[Kotlin/Array|المصفوفة]] أو المجموعة التكرارية التي استُدعيت معها وبين المجموعة التكرارية المُمرّرة إليها في مجموعةٍ واحدةٍ من النوع <code>Set</code> بعد حذف العناصر المتكررة. | ||
===<code>[[Kotlin/collections/windowed|windowed]]</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|مُكرّرًا]] (iterator) يغلّف كل عنصر أنتجه <nowiki/>[[Kotlin/iterator|المكرّر]] (Iterator) المستدعى مع الدالة مع القيمة المُفهرسة أي يعيد القيمة مع فهرسها. | ||
===<code>[[Kotlin/collections/zip|zip]]</code>=== | ===<code>[[Kotlin/collections/zip|zip]]</code>=== | ||
تنشئ الدالة <code>zip()</code> أزواجًا من عناصر كائنين لها نفس الفهرس، أو تنشئ قيمًا عبر تمرير عناصر لها نفس الفهرس تجلب من كائنين مختلفين إلى دالة معينة. | |||
===<code>[[Kotlin/collections/zipWithNext|zipWithNext]]</code>=== | |||
==مصادر== | |||
*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/-match-group-collection/index.html صفحة الواجهة MatchGroupCollection في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.] | |||
[[تصنيف:Kotlin]] | [[تصنيف:Kotlin]] | ||
[[تصنيف:Kotlin | [[تصنيف:Kotlin Interface]] | ||
[[تصنيف:Kotlin Text]] | |||
[[تصنيف:Kotlin MatchGroup]] | |||
[[تصنيف:Kotlin MatchGroupCollection]] | [[تصنيف:Kotlin MatchGroupCollection]] | ||
المراجعة الحالية بتاريخ 05:36، 10 سبتمبر 2018
تمثل الواجهة MatchGroupCollection مجموعةً (collection) من الفئات المرصودة (captured groups) عند إجراء مطابقة واحدة لتعبير نمطي ما.
حجم المجموعة يساوي groupCount + 1، إذ يمثل groupCount عدد الفئات (groups) في التعبير النمطي. الفئات مُفهرسة بدءًا من 1 وحتى groupCount، والفئة ذات الفهرس 0 تقابل كل ما تطابق.
يمكن أن يساوي بعض عناصر المجموعة القيمة العدمية (null) في حال كانت الفئة المقابلة في التعبير النمطي اختيارية، ولم يُرصَد أي تطابق من قبل تلك الفئة.
interface MatchGroupCollection : Collection<MatchGroup?>
الدوال
get
تعيد هذه الدالة نسخةً من الصنف MatchGroup إن كانت المجموعة التي تحمل الاسم المُمرّر إليها متطابقَة.
الوارثات (Inheritors)
MatchNamedGroupCollection
توسِّع هذه الواجهة الصنف MatchGroupCollection عبر تعريف طريقةٍ لجلب المجموعات المتطابقة (matched groups) عن طريق أسمائها عندما يدعم regex ذلك.
الخاصيات الإضافية (Extension Properties)
indices
تُستخدَم هذه الخاصيّة للحصول على الفهارس الصحيحة (valid indices) للمصفوفة أو المجموعة (collection).
الدوال الإضافية (Extension Functions)
all
تتحقق الدالة all() إن كانت كافّة عناصر المصفوفة أو المجموعة (collection) التي استُدعيت عبرها تطابق شرطًا منطقيًّا محدَّدًا.
any
يختلف سلوك الدالة any() بحسب طريقة استدعائها، وسنناقش هذه الحالات تباعًا.
asIterable
تُنشِئ الدالة asIterable()نسخةً تكراريّةً (iterable instance) تُغلّف (wrap) المصفوفة الأصلية وتعيد عناصرَها عندما تُستخدَم في حلقات التكرار (مثل for).
asSequence
تُنشِئ الدالة asSequence() نسخةً (instance) من النوع sequence والتي تُغلّف المصفوفة الأصلية وتعيد عناصرها عندما تُستخدَم في حلقات التكرار (مثل حلقة for).
associate
تعيد الدالة associate() خريطةً (map) تحوي أزواجًا من "مفتاح/قيمة" ناتجة عن تمرير عناصر المصفوفة أو المجموعة (Collection) إلى الدالة المررة إليها.
associateBy
تعيد الدالة associateBy() خريطةً (map) مكونة من الأزواج "مفتاح/قيمة"، إذ يكون المفتاح (key) هو الناتج الذي تعيده الدالة keySelector الممررة إليها وتكون القيمة (value) المقابلة لذلك المفتاح هي إمَّا عناصر المصفوفة أو المجموعة المعطاة أو الناتج الذي تعيده الدالة valueTransform الممررة.
associateByTo
تشبه الدالة associateByTo() الدالة associateBy() تمامًا باستثناء أنها تضيف الناتج الذي تعيده إلى خريطة موجودة مسبقًا.
associateTo
تشبه الدالة associateTo() الدالة associate() تمامًا باستثناء أنها تضيف الناتج الذي تعيده إلى خريطة موجودة مسبقًا.
chunked
contains
تتحقق الدالة contains() إن كانت المصفوفة أو المجموعة التي استُدعيت معها تحتوي على العنصر الممرّر إليها، أو إن كانت الخريطة التي استدعيت معها تحتوي على ذلك العنصر كمفتاح (key).
containsAll
count
تعيد الدالة count() عدد جميع عناصر المصفوفة أو المجموعة أو الخريطة التي استُدعيت معها أو العناصر التي تحقق شرطًا معينًا.
distinct
تحذف الدالة distinct() العناصر المتكررة الموجودة في المصفوفة أو المجموعة التي استُدعيت معها وتعيد الناتج في قائمة.
distinctBy
تعيد الدالة distinctBy() قائمة تحتوي على العناصر الموجودة في المصفوفة أو المجموعة التي استُدعيت معها والتي تعطي نتيجة مختلفة عند تطبيق الدالة selector عليها فقط.
drop
تعيد الدالة drop() قائمة تحوي جميع عناصر المصفوفة أو المجموعة التي استُدعيت معها باستثناء أول n عنصر.
dropWhile
تعيد الدالة dropWhile() قائمةً تحوي جميع عناصر المصفوفة أو المجموعة التي استُدعيت معها باستثناء العناصر الأولى التي تحقق شرطًا معيَّنًا.
elementAt
تجلب الدالة elementAt() عنصرًا ذي فهرس معيَّن من المصفوفة أو المجموعة التي استُدعيت معها.
elementAtOrElse
تجلب الدالة elementAtOrElse() عنصرًا ذي فهرس معيَّن من المصفوفة أو المجموعة التي استُدعيت معها. إن كان الفهرس المعطى خارج حدود المصفوفة أو المجموعة، فستُعيد الدالة ناتج استدعاء دالة معينة.
elementAtOrNull
تعيد الدالةelementAtOrNull() العنصر الموجود عند الفهرس (index) المحدد من المصفوفة أو المجموعة التي استُدعيت عبرها، وفي حال كان ذلك الفهرس خارج حدود المصفوفة أو المجموعة فستُعيد القيمة المعدومة null.
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() تمامًا باستثناء أنها تضيف الناتج المعاد إلى كائن موجود مسبقًا بدلًا من إعادته فقط.
fold
تجمع الدالة fold() تراكميًّا ناتج تطبيق عملية معينة على قيمة كل عنصر من عناصر الكائن المستدعى معها والقيمة التراكمية الحالية بالإضافة إلى قيمة أولية إن أعطيت.
foldIndexed
تجمع الدالة foldIndexed() ناتج تطبيق عملية معينة على قيمة كل عنصر من عناصر المصفوفة أو المجموعة (بدءًا من اليسار إلى اليمين) المستدعاة معها وفهرس ذلك العنصر بشكل تراكمي بالإضافة إلى القيمة الأولية إن أعطيت.
forEach
تُنفّد الدالةُ forEach() الدالةَ المُمرّرةَ إليها على كل عنصر من عناصر المصفوفة أو المجموعة أو الخريطة التي استُدعيت معها.
forEachIndexed
تُنفّد الدالةُ forEachIndexed() الدالةَ المُمرّرةَ إليها على كل عنصر من عناصر المصفوفة، أو المجموعة، أو الخريطة، التي استُدعيت معها وعلى فهرس ذلك العنصر.
groupBy
تجمِّع الدالة groupBy() عناصر المصفوفة أو المجموعة التي استُدعيت معها في مجموعات، إذ تطبق دالة محدَّدة على كل عنصر ثمَّ تعاد خريطة تحوي مجموعاتٍ مفتاحُ كلِّ واحدةٍ منها مرتبطٌ بقائمة من العناصر المقابلة.
groupByTo
تشبه الدالة groupByTo() الدالة groupBy() في جميع النواحي باستثناء أنَّها تضيف الناتج المعاد إلى المعامل الممرَّر إليها.
groupingBy
تُنشئ الدالة groupingBy() موردًا (source) من النوع Grouping من المصفوفة أو المجموعة التي استُدعيت معها لاستخدامه لاحقًا مع عمليات التجميع (group-and-fold operations) وذلك باستخدام الدالة keySelector المُمرّرة إليها لاستخلاص مفتاح من كل عنصر.
indexOf
تجلب الدالة indexOf() فهرس أول ظهور لعنصر محدَّد من المصفوفة أو المجموعة أو القائمة التي استُدعيت معها.
indexOfFirst
تجلب الدالة indexOfFirst() فهرس أول عنصر يحقِّق شرطًا معيَّنًا من المصفوفة أو المجموعة أو القائمة التي استُدعيت معها.
indexOfLast
تجلب الدالة indexOfLast() فهرس آخر عنصر يحقِّق شرطًا معيَّنًا من المصفوفة أو المجموعة أو القائمة التي استُدعيت معها.
intersect
تبحث الدالة intersect() عن العناصر المشتركة بين مصفوفتين أو مجموعتين ثمَّ تعيدها في مجموعة.
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 المعطى.
minus
minusElement
none
تتحقَّق الدالة none() إن كانت المصفوفة أو المجموعة أو الخريطة التي استدعيت معها فارغةً، أو إن لم يكن هنالك أي عنصر من تلك العناصر محقِّقًا لشرط معين.
orEmpty
تعيد الدالة orEmpty() المصفوفة أو المجموعة أو القائمة أو الخريطة التي استُدعيت معها إن لم تكن مساويةً للقيمة null، أو تعيد كائنًا فارغًا يقابل الكائن المعطى (مصفوفة فارغة، أو مجموعة فارغة ...إلخ.) خلاف ذلك.
partition
تقسم الدالة partition() المصفوفة أو المجموعة التي استُدعيت معها إلى قسمين؛ الأول يضم العناصر التي تحقِّق شرطًا محدَّدًا، والثاني يضم العناصر الأخرى المتبقيَّة.
plus
تضيف الدالة plus() الوسيط المُمرَّر إليها إلى الكائن الذي استدعيت معه.
plusElement
تضيف الدالة plusElement() العنصر المُمرّر إليها إلى المصفوفة أو المجموعة التي استُدعيت معها.
reduce
تُراكِم الدالة reduce() قيمة عنصر بدءًا من العنصر الأول عبر تطبيق عملية معينة من يسار العناصر المعطاة إلى يمينها على القيمة المتراكمة الحالية وعلى العنصر التالي ثم تُعيد قيمة العنصر النهائي الناتج.
reduceIndexed
تجمع الدالة reduceIndexed() ناتج تطبيق عملية معينة على قيمة كل عنصر من عناصر المصفوفة أو المجموعة (بدءًا من اليسار إلى اليمين) المستدعاة معها وفهرس ذلك العنصر بشكل تراكمي والقيمة المجمَّعة الحالية.
requireNoNulls
تعيد الدالة requireNoNulls() العناصر غير المعدومة (non-null) من المصفوفة أو المجموعة أو القائمة التي استُدعيت معها أو ترمي استثناءً إن وجد عنصر معدوم (null).
reversed
تُعيد الدالة reversed() قائمة تضم عناصر المصفوفة أو المجموعة التي استُدعيت معها بترتيب معكوس.
shuffled
single
تتحقَّق الدالة single() من حواية المصفوفة أو المجموعة أو القائمة التي استُدعيت معها عنصرًا واحدًا فقط أو عنصرًا واحدًا محققًا لشرط معيَّن ثمَّ تعيده أو تطلق استثناءً خلاف ذلك.
singleOrNull
تتحقَّق الدالة singleOrNull() من حواية المصفوفة أو المجموعة أو القائمة التي استُدعيت معها عنصرًا واحدًا فقط، أو عنصرًا واحدًا محققًا لشرط معيَّن ثمَّ تعيده، أو تعيد القيمة nullخلاف ذلك.
sorted
ترتِّب الدالة sorted() جميع عناصر المصفوفة أو المجموعة التكرارية التي استُدعيت معها تصاعديًّا ثمَّ تضع الناتج في قائمة.
sortedBy
ترتِّب الدالة sortedBy() جميع عناصر المصفوفة أو المجموعة التكرارية (Iterable) التي استُدعيت معها تصاعديًّا وفقًا للقيم التي تعيدها الدالة المُمرّرة إليها عند تطبيقها على كل عنصر ثمَّ تضع الناتج في قائمة.
sortedByDescending
ترتِّب الدالة sortedByDescending() جميع عناصر المصفوفة أو المجموعة التكرارية (Iterable) التي استُدعيت معها تنازليًّا وفقًا للقيم التي تعيدها الدالة المُمرّرة إليها عند تطبيقها على كل عنصر ثمَّ تضع الناتج في قائمة.
sortedDescending
ترتِّب الدالة sortedDescending() جميع عناصر المصفوفة أو المجموعة التكرارية التي استُدعيت معها تنازليًّا ثمَّ تضع الناتج في قائمة.
sortedWith
ترتِّب الدالة sortedWith() جميع عناصر المصفوفة أو المجموعة التكرارية التي استُدعيت معها وفقًا للمُقارِن المُمرّر إليها ثمَّ تضع الناتج في قائمة.
subtract
تستثني الدالة subtract() العناصر المشتركة بين كائنين.
sumBy
تجمع الدالة sumBy() جميع نواتج تطبيق دالة معيَّنة على كل عنصر من عناصر المصفوفة أو المجموعة التي استُدعيت معها.
sumByDouble
تجمع الدالة sumByDouble() جميع نواتج تطبيق دالة معيَّنة على كل عنصر من عناصر المصفوفة أو المجموعة التي استُدعيت معها.
take
تجلب الدالة take() أول n عنصر من المصفوفة أو المجموعة التكرارية التي استُدعيت معها وتضعها في قائمة.
takeWhile
تجلب الدالة takeWhile() أول عناصر محققة لشرطٍ محدَّدٍ من المصفوفة أو القائمة التي استُدعيت معها.
toCollection
تضيف الدالة toCollection() جميع عناصر المصفوفة أو المجموعة التي استُدعيت معها إلى المجموعة المتغيرة (MutableCollection) المُمرّرة إليها.
toHashSet
تعيد الدالة toHashSet() كائنًا من النوع HashSet لجميع عناصر المصفوفة أو المجموعة التي استُدعيت معها.
toList
تحول الدالة toList() المصفوفة أو المجموعة التكرارية أو الخريطة التي استُدعيت معها إلى قائمة.
toMutableSet
تحول الدالة toMutableSet() المصفوفة أو المجموعة التكرارية التي استُدعيت معها إلى مجموعة من النوع MutableSet؛ تحافظ المجموعة المُعادة على نفس ترتيب تكرار المصفوفة أو المجموعة التكرارية الأصلية.
toSet
تحول الدالة toSet() المصفوفة أو المجموعة التكرارية التي استُدعيت معها إلى مجموعة من النوع Set. تحافظ المجموعة المُعادة على نفس ترتيب تكرار المصفوفة أو المجموعة التكرارية الأصلية.
toTypedArray
union
تجمع الدالة union() العناصر المشتركة وغير المتشركة بين المصفوفة أو المجموعة التكرارية التي استُدعيت معها وبين المجموعة التكرارية المُمرّرة إليها في مجموعةٍ واحدةٍ من النوع Set بعد حذف العناصر المتكررة.
windowed
unzip
تعيد الدالة unzip() قائمتين، إذ تحتوي الأولى على القيم الأولى لكل زوج من أزواج المصفوفة أو المجموعة التكرارية التي استُدعيت معها وتحتوي الثانية على القيم الثانية لكل زوج من تلك الأزواج.
withIndex
تعيد الدالة withIndex() مجموعة تكرارية خاملة (lazy Iterable) من القيم المُفهرسة لكل عنصر من عناصر المصفوفة أو المجموعة التكرارية التي استُدعيت معها، أو تعيد مُكرّرًا (iterator) يغلّف كل عنصر أنتجه المكرّر (Iterator) المستدعى مع الدالة مع القيمة المُفهرسة أي يعيد القيمة مع فهرسها.
zip
تنشئ الدالة zip() أزواجًا من عناصر كائنين لها نفس الفهرس، أو تنشئ قيمًا عبر تمرير عناصر لها نفس الفهرس تجلب من كائنين مختلفين إلى دالة معينة.