الفرق بين المراجعتين لصفحة: «Kotlin/BooleanArray»
لا ملخص تعديل |
لا ملخص تعديل |
||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE:الصنف <code>BooleanArray</code> في Kotlin}}</noinclude> | |||
== الدوال البانية == | == الدوال البانية == | ||
[[Kotlin/BooleanArray/Init|init]] | [[Kotlin/BooleanArray/Init|init]] | ||
| سطر 209: | سطر 211: | ||
=== <code>[[Kotlin/collections/joinToString|joinToString]]</code> === | === <code>[[Kotlin/collections/joinToString|joinToString]]</code> === | ||
تنشئ الدالة<code>joinToString()</code> سلسة نصية من عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت عبرها مفصولة بالمعامل المُمرّر <code>separator</code> وباستخدام البادئة <code>prefix</code> واللاحقة <code>postfix</code> في حال تمريرهما، | |||
=== <code>[[Kotlin/collections/last|last]]</code> === | === <code>[[Kotlin/collections/last|last]]</code> === | ||
تعيد الدالة<code>last()</code> العنصر الأخير من <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] أو اللائحة التي استُدعيت عبرها. في حال تمرير شرط منطقي <code>predicate</code> كوسيط فستعيد العنصر الأخير الذي يحقق ذلك الشرط. | |||
=== <code>[[Kotlin/collections/lastIndexOf|lastIndexOf]]</code> === | === <code>[[Kotlin/collections/lastIndexOf|lastIndexOf]]</code> === | ||
تعيد الدالة<code>lastIndexOf()</code> آخر فهرس للعنصر الممرّر إلى <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] أو اللائحة التي استُدعيت عبرها. وإن لم يكن العنصر موجودًا فستعيد <code>-1</code>. | |||
=== <code>[[Kotlin/collections/lastOrNull|lastOrNull]]</code> === | === <code>[[Kotlin/collections/lastOrNull|lastOrNull]]</code> === | ||
تعيد الدالة<code>lastOrNull()</code> العنصر الأخير من <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] أو اللائحة التي استُدعيت عبرها. في حال تمرير شرط منطقي <code>predicate</code> كوسيط فستعيد العنصر الأخير الذي يحقق ذلك الشرط. | |||
=== <code>[[Kotlin/collections/map|map]]</code> === | === <code>[[Kotlin/collections/map|map]]</code> === | ||
تعيد الدالة<code>map()</code> لائحة تضم ناتج تطبيق الدالة <code>transform()</code> المُمرّرة إليها على عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت عبرها، وفي حال استدعاء الدالة <code>map()</code> على قاموس فستعيد لائحة تضم ناتج تطبيق الدالة <code>transform()</code> على مداخل (entries) القاموس. | |||
=== <code>[[Kotlin/collections/mapIndexed|mapIndexed]]</code> === | === <code>[[Kotlin/collections/mapIndexed|mapIndexed]]</code> === | ||
تعيد الدالة<code>mapIndexed()</code> لائحة تضم ناتج تطبيق الدالة <code>transform()</code> المُمرّرة إليها على عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت عبرها وعلى فهارسها. | |||
=== <code>[[Kotlin/collections/mapIndexedTo|mapIndexedTo]]</code> === | === <code>[[Kotlin/collections/mapIndexedTo|mapIndexedTo]]</code> === | ||
تطبق الدالة<code>mapIndexedTo()</code> الدالة المُمررّة <code>transform()</code> على عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت عبرها وعلى فهارسها وتضيف النتائج إلى المعامل الممرّر <code>destination</code>. | |||
=== <code>[[Kotlin/collections/mapTo|mapTo]]</code> === | === <code>[[Kotlin/collections/mapTo|mapTo]]</code> === | ||
تطبق الدالة<code>mapTo()</code> الدالة المُمررّة <code>transform()</code> على عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت عبرها وتضيف النتائج إلى المعامل الممرّر<code>destination</code>. وفي حال استدعاء الدالة <code>mapTo()</code> على قاموس فستضيف نتائج تطبيق الدالة<code>transform()</code> على مداخل (entries) القاموس إلى المعامل الممرّر <code>destination</code>. | |||
=== <code>[[Kotlin/collections/maxBy|maxBy]]</code> === | === <code>[[Kotlin/collections/maxBy|maxBy]]</code> === | ||
تعيد الدالة<code>maxBy()</code> العنصر الأول في <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت عبره والذي له أكبر قيمة معادة من الدالة الممررة <code>selector</code>، أو <code>null</code> إن لم يكن هناك أي عنصر يحقق ذلك. | |||
=== <code>[[Kotlin/collections/maxWith|maxWith]]</code> === | === <code>[[Kotlin/collections/maxWith|maxWith]]</code> === | ||
تعيد الدالة<code>maxWith()</code> العنصر الأول في <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت عبره والذي له أكبر قيمة بحسب المقارِن <code>comparator</code> الممرّر، أو <code>null</code>إن لم يكن هناك أي عنصر يحقق ذلك. | |||
=== <code>[[Kotlin/collections/minBy|minBy]]</code> === | === <code>[[Kotlin/collections/minBy|minBy]]</code> === | ||
تعيد الدالة<code>minBy()</code> العنصر الأول في <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت عبره والذي له أصغر قيمة معادة من الدالة الممررة <code>selector</code>، أو <code>null</code> إن لم يكن هناك أي عنصر يحقق ذلك. | |||
=== <code>[[Kotlin/collections/minWith|minWith]]</code> === | === <code>[[Kotlin/collections/minWith|minWith]]</code> === | ||
تعيد الدالة<code>minWith()</code> العنصر الأول في <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت عبرها والذي له أصغر قيمة بحسب المقارِن <code>comparator</code> الممرّر، أو<code>null</code> إن لم يكن هناك أي عنصر يحقق ذلك. | |||
=== <code>[[Kotlin/collections/none|none]]</code> === | === <code>[[Kotlin/collections/none|none]]</code> === | ||
تعيد الدالة<code>none()</code> القيمة <code>true</code> إن كانت <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت عبرها فارغة، أو تعيد <code>false</code>. وفي حال تمرير شرط منطقي<code>predicate</code>. فستعيد <code>true</code> إن لم يكن هناك أي عنصر يحقق ذلك الشرط المنطقي، أو تعيد <code>false</code>. | |||
=== <code>[[Kotlin/collections/partition|partition]]</code> === | === <code>[[Kotlin/collections/partition|partition]]</code> === | ||
تُقسّم الدالةُ<code>partition()</code> <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت عبرها إلى زوج مكوّن من لائحتين، اللائحة الأولى تضم العناصر التي تحقق الشرط المنطقي المُمرّر <code>predicate</code> (أي تعيد <code>true</code>)، بينما تضم الثانية العناصر الأخرى. | |||
=== <code>[[Kotlin/collections/plus|plus]]</code> === | === <code>[[Kotlin/collections/plus|plus]]</code> === | ||
يختلف سلوك الدالة <code>plus()</code> حسب نوع الكائنات التي استُدعيت عبرها ونوع الوسائط الممررة (انظر فقرة <nowiki/>[[Kotlin/collections/plus#.D8.A7.D9.84.D8.A8.D9.86.D9.8A.D8.A9 .D8.A7.D9.84.D8.B9.D8.A7.D9.85.D8.A9|البنية العامة]]). | |||
=== <code>[[Kotlin/collections/reduce|reduce]]</code> === | === <code>[[Kotlin/collections/reduce|reduce]]</code> === | ||
يختلف سلوك الدالة<code>reduce()</code> حسب نوع الكائنات التي استُدعيت عبرها ونوع المعاملات (parameters) المُمرّرة إليها (انظر فقرة <nowiki/>[[Kotlin/collections/reduce#.D8.A7.D9.84.D8.A8.D9.86.D9.8A.D8.A9 .D8.A7.D9.84.D8.B9.D8.A7.D9.85.D8.A9|البنية العامة]]). | |||
=== <code>[[Kotlin/collections/reduceIndexed|reduceIndexed]]</code> === | === <code>[[Kotlin/collections/reduceIndexed|reduceIndexed]]</code> === | ||
تُراكِم الدالة<code>reduceIndexed()</code> القيم بدءًا من العنصر الأول في <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت عبرها وتطبّق العملية <code>operation</code> من اليسار إلى اليمين على القيمة المُتراكمة الراهنة وعلى العنصر الموالي في <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت عبرها وعلى فهرسه. ثم تُعيد القيمة النهائية. | |||
=== <code>[[Kotlin/collections/reduceRight|reduceRight]]</code> === | === <code>[[Kotlin/collections/reduceRight|reduceRight]]</code> === | ||
تُراكِم الدالة<code>reduceRight()</code> القيم بدءًا من العنصر الأخير وتطبّق العملية <code>operation</code> من اليمين إلى اليسار على العنصر الموالي في <nowiki/>[[Kotlin/Array|المصفوفة]] أواللائحة التي استُدعيت عبرها وعلى القيمة المُتراكمة الراهنة. ثم تُعيد القيمة النهائية. | |||
=== <code>[[Kotlin/collections/reduceRightIndexed|reduceRightIndexed]]</code> === | === <code>[[Kotlin/collections/reduceRightIndexed|reduceRightIndexed]]</code> === | ||
تُراكِم الدالة<code>reduceRightIndexed()</code> القيم بدءًا من العنصر الأخير في <nowiki/>[[Kotlin/Array|المصفوفة]] أو اللائحة التي استُدعيت عبرها وتطبّق العملية <code>operation</code> من اليمين إلى اليسار على القيمة المُتراكمة الراهنة وعلى العنصر الموالي في <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت عبرها وعلى فهرسه. ثم تُعيد القيمة النهائية. | |||
=== <code>[[Kotlin/collections/reverse|reverse]]</code> === | === <code>[[Kotlin/collections/reverse|reverse]]</code> === | ||
تعكس الدالة<code>reverse()</code> ترتيب عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو اللائحة التي استُدعيت عبرها. | |||
=== <code>[[Kotlin/collections/reversed|reversed]]</code> === | === <code>[[Kotlin/collections/reversed|reversed]]</code> === | ||
تُعيد الدالة<code>reversed()</code> لائحة تضم عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت عبرها بالترتيب المعكوس. | |||
=== <code>[[Kotlin/collections/reversedArray|reversedArray]]</code> === | === <code>[[Kotlin/collections/reversedArray|reversedArray]]</code> === | ||
تُعيد الدالة<code>reversedArray()</code> <nowiki/>[[Kotlin/Array|مصفوفة]] تضم عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] التي استُدعيت عبرها بالترتيب المعكوس. | |||
=== <code>[[Kotlin/collections/single|single]]</code> === | === <code>[[Kotlin/collections/single|single]]</code> === | ||
تعيد الدالة<code>single()</code>العنصر الوحيد الموجود في <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] أو اللائحة التي استُدعيت عبرها، وفي حال تمرير شرط منطقي <code>predicate</code>كمعامل (parameter) فستعيد العنصر الوحيد الذي يحقق ذلك الشرط المنطقي. أمّا في حال كان الكائن الذي استُدعيت عبره يحتوي أكثر من عنصر واحد (يحقق <code>predicate</code> في حال تمريرها) أو لا يحتوي أي واحد (يحقق <code>predicate</code> في حال تمريرها) فستطلق الدالة <code>single()</code>[[Kotlin/exceptions|استثناءً]]. | |||
=== <code>[[Kotlin/collections/singleOrNull|singleOrNull]]</code> === | === <code>[[Kotlin/collections/singleOrNull|singleOrNull]]</code> === | ||
تعيد الدالة<code>singleOrNull()</code>العنصر الوحيد الموجود في <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] أو اللائحة التي استُدعيت عبرها، وفي حال تمرير شرط منطقي<code>predicate</code> كمعامل (parameter) فستعيد العنصر الوحيد الذي يحقق ذلك الشرط المنطقي. أمّا في حال كان الكائن الذي استُدعيت عبره يحتوي أكثر من عنصر واحد (يحقق <code>predicate</code> في حال تمريرها) أو لا يحتوي أي واحد (يحقق <code>predicate</code> في حال تمريرها) فستعيد القيمة المعدومة <code>null</code>. | |||
=== <code>[[Kotlin/collections/slice|slice]]</code> === | === <code>[[Kotlin/collections/slice|slice]]</code> === | ||
تعيد الدالة<code>slice()</code>لائحة تحتوي عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو اللائحة التي استُدعيت عبرها والموجودة عند الفهارس التي يحددها الوسيط الممرّر <code>indices</code>. | |||
=== <code>[[Kotlin/collections/sliceArray|sliceArray]]</code> === | === <code>[[Kotlin/collections/sliceArray|sliceArray]]</code> === | ||
تعيد الدالة<code>sliceArray()</code>لائحة أو <nowiki/>[[Kotlin/Array|مصفوفة]] تحتوي عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] التي استُدعيت عبرها والموجودة عند الفهارس التي يحددها الوسيط الممرّر<code>indices</code>. | |||
=== <code>[[Kotlin/collections/sortedBy|sortedBy]]</code> === | === <code>[[Kotlin/collections/sortedBy|sortedBy]]</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>[[Kotlin/collections/sortedWith|sortedWith]]</code> === | === <code>[[Kotlin/collections/sortedWith|sortedWith]]</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>[[Kotlin/collections/sumBy|sumBy]]</code> === | === <code>[[Kotlin/collections/sumBy|sumBy]]</code> === | ||
تعيد الدالة<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>[[Kotlin/collections/take|take]]</code> === | === <code>[[Kotlin/collections/take|take]]</code> === | ||
تعيد الدالة<code>take()</code> لائحة تضم <code>n</code> من أولى العناصر الموجودة في <nowiki/>[[Kotlin/Array|المصفوفة]] أو المجموعة التكرارية التي استُدعيت عبرها. | |||
=== <code>[[Kotlin/collections/takeLast|takeLast]]</code> === | === <code>[[Kotlin/collections/takeLast|takeLast]]</code> === | ||
=== <code>[[Kotlin/collections/takeLastWhile|takeLastWhile]]</code> === | تعيد الدالة<code>takeLast()</code> لائحة تضم آخر <code>n</code> من العناصر الموجودة في <nowiki/>[[Kotlin/Array|المصفوفة]] أو المجموعة التكرارية التي استُدعيت عبرها. | ||
=== <code>[[Kotlin/collections/takeLastWhile|takeLa]]</code> === | |||
=== تعيد الدالة<code>takeLastWhile()</code> لائحة تضم آخر عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو اللائحة التي استُدعيت عبرها والتي تحقق الشرط المنطقي المُمرّر <code>predicate</code>.<code>[[Kotlin/collections/takeLastWhile|stWhile]]</code> === | |||
=== <code>[[Kotlin/collections/takeWhile|takeWhile]]</code> === | === <code>[[Kotlin/collections/takeWhile|takeWhile]]</code> === | ||
تعيد الدالة<code>takeWhile()</code> لائحة تضم أولى عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو المجموعة التكرارية التي استُدعيت عبرها والتي تحقق الشرط المنطقي المُمرّر<code>predicate</code>. | |||
=== <code>[[Kotlin/collections/toCollection|toCollection]]</code> === | === <code>[[Kotlin/collections/toCollection|toCollection]]</code> === | ||
تضيف الدالة<code>toCollection()</code> عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت عبرها إلى المجموعة المتغيرة (<code>MutableCollection</code>) المُمرّرة<code>destination</code>. | |||
=== <code>[[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>toList()</code> عبر قاموسفستعيد لائحة تضم جميع الأزواج مفتاح/قيمة المنتمية إليه. | |||
=== <code>[[Kotlin/collections/toMutableList|toMutableList]]</code> === | === <code>[[Kotlin/collections/toMutableList|toMutableList]]</code> === | ||
تعيد الدالة<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>[[Kotlin/collections/toSet|toSet]]</code> === | === <code>[[Kotlin/collections/toSet|toSet]]</code> === | ||
تعيد الدالة<code>toSet()</code> مجموعة من النوع <code>Set</code> تضم جميع عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو المجموعة التكرارية التي استُدعيت عبرها. | |||
=== <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>[[Kotlin/collections/union|union]]</code> === | === <code>[[Kotlin/collections/union|union]]</code> === | ||
تعيد الدالة<code>union()</code> مجموعة من النوع Set تضم جميع عناصر <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>[[Kotlin/collections/zip|zip]]</code> === | === <code>[[Kotlin/collections/zip|zip]]</code> === | ||
يختلف سلوك الدالة<code>zip()</code> بحسب إمضائها، أنظر فقرة <nowiki/>[[Kotlin/collections/zip#.D8.A7.D9.84.D8.A8.D9.86.D9.8A.D8.A9 .D8.A7.D9.84.D8.B9.D8.A7.D9.85.D8.A9|البنية العامة]] لأجل التفاصيل. | |||
[[تصنيف:Kotlin]] | |||
[[تصنيف:Kotlin Classes]] | |||
[[تصنيف:Kotlin BooleanArray]] | |||
# | |||
مراجعة 12:11، 14 يوليو 2018
الدوال البانية
يعيد التابع BooleanArray() مصفوفة حجمها هو المعامل المُمرّر size، بحيث أنّ كل عنصر منها يُحسب باستدعاء الدالة المُمرّرة init على قيمة الفهرس الحالي. في حال تمرير الوسيط size فقط فكل القيم ستساوي false.
الخاصيات
size
تعبِّر الخاصيّة size عن عدد العناصر الموجودة في المصفوفة.
الدوال
get
يعيد التابع get() قيمة العنصر في المصفوفة عند الفهرس (index) المُحدَّد.
iterator
يعيد التابع iterator() عنصرًا تكراريًّا (iterator) بهدف تكرار بنيةٍ (block) برمجيةٍ على كافّة عناصر المصفوفة.
set
يُعيِّن التابع set() قيمة العنصر في المصفوفة عند الفهرس (index) المُحدَّد، كما يمكن أيضًا استدعاء هذا التابع باستخدام الإسناد (assignment) ومعامل الفهرسة (index operator) بالشكل:
الدوال الموروثة
equals
تبين الدالة equals() إذا ما كان الكائن المُمرّر إليها يساوي الكائن الذي استدعيت عبره.
hashCode
يعيد التابع hashCode() قيمة الشيفرة hash code الخاصّة بالكائن الذي استُدعي عبره.
toString
يعيد التابع toString() تمثيلًا نصيًا للكائن الذي يُستدعى عبره.
الخاصيات الإضافية (Extension Properties)
indices
تُستخدَم هذه الخاصيّة للحصول على الفهارس الصحيحة (valid indices) للمصفوفة أو المجموعة (collection).
lastIndex
الدوال الإضافية (Extension Functions)
all
تُعيد الدالة all() القيمة true إن كانت كافّة عناصر المصفوفة أو المجموعة (collection) التي استُدعيت عبرها تحقق العبارة المنطقية (predicate) المُحدَّدة، أو تعيد القيمة false بخلاف ذلك.
any
يختلف سلوك الدالة any() بحسب طريقة استدعائها، وسنناقش هذه الحالات تباعًا.
asIterable
تُنشِئ الدالة asIterable()نسخةً تكراريّةً (iterable instance) تُغلّف (wrap) المصفوفة الأصلية وتعيد عناصرَها عندما تُستخدَم في حلقات التكرار (مثل for).
asList
تُعيد الدالة asList() قائمةً (list) تُغلّف المصفوفة الأصلية التي استُدعيت عبرها.
asSequence
تُنشِئ الدالة asSequence() نسخةً (instance) من النوع sequence والتي تُغلّف المصفوفة الأصلية وتعيد عناصرها عندما تُستخدَم في حلقات التكرار (مثل حلقة for).
associate
تعيد الدالة associate() خريطةً (map) تحوي أزواجًا من "مفتاح/قيمة" ناتجة عن تمرير عناصر المصفوفة أو المجموعة (Collection) إلى الدالة()transform.
associateBy
تعيد الدالة associateBy() خريطةً (map) تحتوي على عناصر المصفوفة أو المجموعة (Collection) المعطاة مفهرسةً بقيمة المفتاح المعاد من تمرير تلك العناصر إلى الدالة valueTransform.
associateByTo
تعيد الدالة associateByTo() خريطةً متغيرةً (mutable map) تحتوي على أزواج من "قيمة/مفتاح"، إذ القيمة هي عناصر المصفوفة أو المجموعة (Collection) المعطاة، والمفتاح هو الناتج المعاد من تمرير تلك العناصر إلى الدالة keySelector.
associateTo
تعيد الدالة associateTo() خريطةً متغيرةً (mutable map) تحتوي على أزواج من "قيمة/مفتاح"، إذ القيمة هي عناصر المصفوفة أو المجموعة (Collection) المعطاة، والمفتاح هو الناتج المعاد من تمرير تلك العناصر إلى الدالة transform.
component1
تعيد الدالة component1() العنصر الأول من المصفوفة أو المفتاح (key) لأول زوج (مفتاح/قيمة) في الخريطة (map) التي استدعيت معها. تسمح هذه الدالة باستخدام التصريحات التفكيكية (destructuring declarations) عند العمل على الخرائط.
contains
تتحقق الدالة contains() إن كانت المصفوفة أو المجموعة التي استُدعيت معها تحتوي على العنصر الممرّر إليها، أو إن كانت الخريطة التي استدعيت معها تحتوي على ذلك العنصر كمفتاح (key).
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() قائمةً تحوي جميع عناصر المصفوفة أو المجموعة التي استُدعيت معها باستثناء العناصر الأخيرة التي تحقق شرطًا معيَّنًا.
dropWhile
تعيد الدالة dropLastWhile() قائمةً تحوي جميع عناصر المصفوفة أو المجموعة التي استُدعيت معها باستثناء العناصر الأولى التي تحقق شرطًا معيَّنًا.
elementAt
تجلب الدالة elementAt() عنصرًا ذي فهرس معيَّن من المصفوفة أو المجموعة التي استُدعيت معها. إن كان فهرس العنصر المعطى خارج حدود المصفوفةأو المجموعة، فستُطلق الدالة الاستثناء IndexOutOfBoundsException.
elementAtOrElse
تجلب الدالة elementAtOrElse() عنصرًا ذي فهرس معيَّن من المصفوفة أو المجموعة التي استُدعيت معها. إن كان الفهرس المعطى خارج حدودالمصفوفة أو المجموعة، فستُعيد الدالة ناتج استدعاء دالة معينة.
elementAtOrNull
تجلب الدالة elementAtOrNull() عنصرًا ذي فهرس معيَّن من المصفوفة أو المجموعة التي استُدعيت معها. إن كان الفهرس المعطى خارج حدودالمصفوفة أو المجموعة، فستُعيد الدالة القيمة العدمية null.
fill
تبدِّل الدالة fill() قيمة جديدة معطاة مكان عناصر محدَّدة في المصفوفة أو القائمة التي تستدعى معها.
filter
ترشِّح الدالة filter() عناصر المصفوفة أو المجموعة أو أزواج الخرائط المعطاة التي تحقِّق شرطًا معيَّنًا ثمّ تعيدها.
filterIndexed
ترشِّح الدالة filterIndexed() عناصر المصفوفة أو المجموعة المعطاة التي أعيدت القيمة true معها عند تطبيق الدالة predicate() المُمرّر عليها، إذ يمرَّر فهرس كل عنصر وقيمته إلى الدالة predicate() ثم تعيد بدورها قيمة منطقيَّة.
filterIndexedTo
تضيف الدالة filterIndexedTo() إلى المجموعة المتغيرة destination المُمرَّر إليها عناصر المصفوفة أو المجموعة المعطاة التي أعيدت القيمة true مع كل عنصر منها عند تطبيق الدالة predicate() المُمرّر عليها. يمرَّر فهرس كل عنصر وقيمته إلى الدالة predicate() ثم تعيد بدورها قيمة منطقيَّة.
filterNot
تعيد الدالةfilterNot() لائحة تحتوي عناصر المصفوفة أو المجموعة التي لا تحقق الشرط المنطقي predicate() المُمرّر إلى الدالة. وفي حال استدعائها عبر قاموس فستعيد قاموسًا جديدًا مكونًا من كل الأزوج التي لا تحقق الشرط المنطقي predicate() الممرر إلى الدالة، هذا القاموسالجديد يحافظ على ترتيب تكرار (entry iteration order) القاموسالأصلي.
filterNotTo
تضيف الدالةfilterNotTo() إلى المعامل destination الممرّر إليها عناصرّ المصفوفة أو المجموعة التي استُدعيت عبرها والتي لا تحقق الشرط المنطقي predicate المُمرّر إليها. من الجدير بالذكر أنّ destination ينبغي أن تكون مجموعة قابلة للتغيير (MutableCollection).
filterTo
تضيف الدالةfilterTo() إلى المعامل destination الممرّر إليها عناصرّ المصفوفة أو المجموعة التي استُدعيت عبرها والتي تحقق الشرط المنطقيpredicate المُمرّر إليها. من الجدير بالذكر أنّ destination ينبغي أن تكون مجموعة قابلة للتغيير (MutableCollection).
find
تعيد الدالةfind() العنصر الأول من المصفوفة أو المجموعة التي استُدعيت عبرها والذي يحقق الشرط المنطقي predicate المُمرّر إليها. وإن لم يكن هناك أي عنصر يحقق ذلك فستعيد null.
findLast
تعيد الدالةfindLast() العنصر الأخير من المصفوفة أو المجموعة التي استُدعيت عبرها والذي يحقق الشرط المنطقي predicate المُمرّر إليها. وإن لم يكن هناك أي عنصر يحقق ذلك فستعيد null.
first
تعيد الدالةfirst() العنصر الأول من المصفوفة أو المجموعة التي استُدعيت عبرها، وفي حال تمرير دالة منطقية كمعامل فستعيد أول عنصر يحقق تلك الدالة.
firstOrNull
تعيد الدالةfirstOrNull() العنصر الأول من المصفوفة أو المجموعة التي استُدعيت عبرها، وفي حال تمرير دالة منطقية كمعامل فستعيد أول عنصر يحقق تلك الدالة.
flatMap
تعيد الدالةflatMap() لائحة تضم ناتج تطبيق الدالة transform() المُمرّرة إليها على عناصر المصفوفة أو المجموعة التي استُدعيت عبرها، وفي حال استدعاء الدالة flatMap() على قاموس فستعيد لائحة تضم ناتج تطبيق الدالة transform() على مداخل (entries) القاموس.
flatMapTo
تضيف الدالةflatMapTo() إلى اللائحة المُتغيرة (MutableCollection) destinationالمُمرّرة إليها ناتج تطبيق الدالة transform() على عناصر المصفوفة أو المجموعة التي استُدعيت عبرها، وفي حال استدعاء الدالة flatMapTo() على قاموس فستضيف إلى اللائحة destination ناتج تطبيق الدالة transform() على مداخل (entries) القاموس.
fold
يختلف سلوك الدالةfold() حسب نوع الكائنات التي استُدعيت عبرها و نوع المعاملات (parameters) المُمرّرة إليها (انظر فقرة البنية العامة).
foldIndexed
تُراكِم الدالةfoldIndexed() القيم بدءًا من القيمة المُمرّرة initial وتطبّق العملية operation من اليسار إلى اليمين على القيمة المُتراكمة الراهنة وعلى العنصر التالي من المصفوفة أو المجموعة التي استُدعيت عبرها وكذلك فهرسه. وتُعيد القيمة النهائية.
foldRight
تُراكِم الدالةfoldRight() القيم بدءًا من القيمة المُمرّرة initial وتطبّق العملية operation من اليمين إلى اليسار على القيمة المُتراكمة الراهنة وعلى العنصر التالي من المصفوفة أو المجموعة التي استُدعيت عبرها. وتُعيد القيمة النهائية.
foldRightIndexed
تُراكِم الدالةfoldRightIndexed() القيم بدءًا من القيمة المُمرّرة initial وتطبّق العملية operation من اليمين إلى اليسار على القيمة المُتراكمة الراهنة وعلى العنصر التالي من المصفوفة أو المجموعة التي استُدعيت عبرها وكذلك فهرسه. وتُعيد القيمة النهائية.
forEach
تُنفّد الدالةُforEach() الدالةَ المُمرّرةَ action على كل عناصر المصفوفة أو المجموعة أو القاموس الذي استُدعيت عبره.
forEachIndexed
تُنفّد الدالةُforEachIndexed() الدالةَ المُمرّرةَ action على كل عناصر المصفوفة أو المجموعة أو القاموس الذي استُدعيت عبره وعلى فهارسها (indices).
getOrElse
تعيد الدالة getOrElse() قيمة العنصر عند الفهرس index المُحدَّد في المصفوفة أو المجموعة التي استُدعيت عبرها. ، أو نتيجة استدعاء الدالة المُمرّرة defaultValue إن كان الفهرس خارج الحدود.
getOrNull
تعيد الدالة getOrNull() قيمة العنصر عند الفهرس index المُحدَّد في المصفوفة أو المجموعة التي استُدعيت عبرها. ، أو null إن كان الفهرس خارج الحدود.
groupBy
تعيد الدالةgroupBy() قاموسًا يُجمّع عناصر المصفوفة أو المجموعة التي استُدعيت عبرها حيث مفاتيحه تعيدها الدالة المُمرّرة keySelector وقيمه لوائحُ تضم عناصر المصفوفة أو المجموعة (أو ناتج تمرير عناصر المصفوفة أو المجموعة على الدالة valueTransform في حال تمريرها).
groupByTo
تجمّع الدالةgroupByTo() عناصر المصفوفة أو المجموعة التي استُدعيت عبرها وتضيفها إلى القاموس.المُمرّر destination حيث مفاتيحه تعيدها الدالة الممرّرة keySelector() مُطبّقة على كل عناصر المصفوفة أو المجموعة، وقيمُه لوائح تضم العناصر المقابلة، وفي حال تمرير معامل ثالثvalueTransform فإنّ القيم ستكون لوائح تضم ناتج تطبيق الدالة valueTransform على العناصر المقابلة . ثم تعيد القاموسdestination.
indexOf
تعيد الدالة indexOf() فهرس أول ظهور للعنصر المُمرّر إليها في المصفوفة أو المجموعة أو اللائحة التي استُدعيت عبرها ، أو -1 إن كان العنصر المُمرّر غير موجود.
indexOfFirst
indexOfLast
تعيد الدالة indexOfLast() فهرس آخر ظهور للعنصر المُمرّر إليها في المصفوفة أو المجموعة أو اللائحة التي استُدعيت عبرها والذي يحقق الشرط المنطقي المُمرّر predicate، أو -1 إن لم يكن هناك أي عنصر يحقق ذلك.
intersect
تعيد الدالة intersect()مجموعة تحتوي كل العناصر المشتركة بين المصفوفة أو المجموعة التي استُدعيت عبرها وتلك الممرّرة إلى الدالة.
isEmpty
تعيد الدالة isEmpty() القيمة true إن كانت المصفوفة التي استُدعيت عبرها فارغةً.
isNotEmpty
تعيد الدالة isNotEmpty() القيمة true إن كانت المصفوفة أو المجموعة التي استُدعيت عبرها غير فارغةً.
joinTo
تجمّع الدالةjoinTo() سلسة نصية من عناصر المصفوفة أو المجموعة التي استُدعيت عبرها مفصولة بالمعامل المُمرّر separator وباستخدام البادئةprefix واللاحقة postfix في حال تمريرهما،
joinToString
تنشئ الدالةjoinToString() سلسة نصية من عناصر المصفوفة أو المجموعة التي استُدعيت عبرها مفصولة بالمعامل المُمرّر separator وباستخدام البادئة prefix واللاحقة postfix في حال تمريرهما،
last
تعيد الدالةlast() العنصر الأخير من المصفوفة أو المجموعة أو اللائحة التي استُدعيت عبرها. في حال تمرير شرط منطقي predicate كوسيط فستعيد العنصر الأخير الذي يحقق ذلك الشرط.
lastIndexOf
تعيد الدالةlastIndexOf() آخر فهرس للعنصر الممرّر إلى المصفوفة أو المجموعة أو اللائحة التي استُدعيت عبرها. وإن لم يكن العنصر موجودًا فستعيد -1.
lastOrNull
تعيد الدالةlastOrNull() العنصر الأخير من المصفوفة أو المجموعة أو اللائحة التي استُدعيت عبرها. في حال تمرير شرط منطقي predicate كوسيط فستعيد العنصر الأخير الذي يحقق ذلك الشرط.
map
تعيد الدالةmap() لائحة تضم ناتج تطبيق الدالة transform() المُمرّرة إليها على عناصر المصفوفة أو المجموعة التي استُدعيت عبرها، وفي حال استدعاء الدالة map() على قاموس فستعيد لائحة تضم ناتج تطبيق الدالة transform() على مداخل (entries) القاموس.
mapIndexed
تعيد الدالةmapIndexed() لائحة تضم ناتج تطبيق الدالة transform() المُمرّرة إليها على عناصر المصفوفة أو المجموعة التي استُدعيت عبرها وعلى فهارسها.
mapIndexedTo
تطبق الدالةmapIndexedTo() الدالة المُمررّة transform() على عناصر المصفوفة أو المجموعة التي استُدعيت عبرها وعلى فهارسها وتضيف النتائج إلى المعامل الممرّر destination.
mapTo
تطبق الدالةmapTo() الدالة المُمررّة transform() على عناصر المصفوفة أو المجموعة التي استُدعيت عبرها وتضيف النتائج إلى المعامل الممرّرdestination. وفي حال استدعاء الدالة mapTo() على قاموس فستضيف نتائج تطبيق الدالةtransform() على مداخل (entries) القاموس إلى المعامل الممرّر destination.
maxBy
تعيد الدالةmaxBy() العنصر الأول في المصفوفة أو المجموعة التي استُدعيت عبره والذي له أكبر قيمة معادة من الدالة الممررة selector، أو null إن لم يكن هناك أي عنصر يحقق ذلك.
maxWith
تعيد الدالةmaxWith() العنصر الأول في المصفوفة أو المجموعة التي استُدعيت عبره والذي له أكبر قيمة بحسب المقارِن comparator الممرّر، أو nullإن لم يكن هناك أي عنصر يحقق ذلك.
minBy
تعيد الدالةminBy() العنصر الأول في المصفوفة أو المجموعة التي استُدعيت عبره والذي له أصغر قيمة معادة من الدالة الممررة selector، أو null إن لم يكن هناك أي عنصر يحقق ذلك.
minWith
تعيد الدالةminWith() العنصر الأول في المصفوفة أو المجموعة التي استُدعيت عبرها والذي له أصغر قيمة بحسب المقارِن comparator الممرّر، أوnull إن لم يكن هناك أي عنصر يحقق ذلك.
none
تعيد الدالةnone() القيمة true إن كانت المصفوفة أو المجموعة التي استُدعيت عبرها فارغة، أو تعيد false. وفي حال تمرير شرط منطقيpredicate. فستعيد true إن لم يكن هناك أي عنصر يحقق ذلك الشرط المنطقي، أو تعيد false.
partition
تُقسّم الدالةُpartition() المصفوفة أو المجموعة التي استُدعيت عبرها إلى زوج مكوّن من لائحتين، اللائحة الأولى تضم العناصر التي تحقق الشرط المنطقي المُمرّر predicate (أي تعيد true)، بينما تضم الثانية العناصر الأخرى.
plus
يختلف سلوك الدالة plus() حسب نوع الكائنات التي استُدعيت عبرها ونوع الوسائط الممررة (انظر فقرة البنية العامة).
reduce
يختلف سلوك الدالةreduce() حسب نوع الكائنات التي استُدعيت عبرها ونوع المعاملات (parameters) المُمرّرة إليها (انظر فقرة البنية العامة).
reduceIndexed
تُراكِم الدالةreduceIndexed() القيم بدءًا من العنصر الأول في المصفوفة أو المجموعة التي استُدعيت عبرها وتطبّق العملية operation من اليسار إلى اليمين على القيمة المُتراكمة الراهنة وعلى العنصر الموالي في المصفوفة أو المجموعة التي استُدعيت عبرها وعلى فهرسه. ثم تُعيد القيمة النهائية.
reduceRight
تُراكِم الدالةreduceRight() القيم بدءًا من العنصر الأخير وتطبّق العملية operation من اليمين إلى اليسار على العنصر الموالي في المصفوفة أواللائحة التي استُدعيت عبرها وعلى القيمة المُتراكمة الراهنة. ثم تُعيد القيمة النهائية.
reduceRightIndexed
تُراكِم الدالةreduceRightIndexed() القيم بدءًا من العنصر الأخير في المصفوفة أو اللائحة التي استُدعيت عبرها وتطبّق العملية operation من اليمين إلى اليسار على القيمة المُتراكمة الراهنة وعلى العنصر الموالي في المصفوفة أو المجموعة التي استُدعيت عبرها وعلى فهرسه. ثم تُعيد القيمة النهائية.
reverse
تعكس الدالةreverse() ترتيب عناصر المصفوفة أو اللائحة التي استُدعيت عبرها.
reversed
تُعيد الدالةreversed() لائحة تضم عناصر المصفوفة أو المجموعة التي استُدعيت عبرها بالترتيب المعكوس.
reversedArray
تُعيد الدالةreversedArray() مصفوفة تضم عناصر المصفوفة التي استُدعيت عبرها بالترتيب المعكوس.
single
تعيد الدالةsingle()العنصر الوحيد الموجود في المصفوفة أو المجموعة أو اللائحة التي استُدعيت عبرها، وفي حال تمرير شرط منطقي predicateكمعامل (parameter) فستعيد العنصر الوحيد الذي يحقق ذلك الشرط المنطقي. أمّا في حال كان الكائن الذي استُدعيت عبره يحتوي أكثر من عنصر واحد (يحقق predicate في حال تمريرها) أو لا يحتوي أي واحد (يحقق predicate في حال تمريرها) فستطلق الدالة single()استثناءً.
singleOrNull
تعيد الدالةsingleOrNull()العنصر الوحيد الموجود في المصفوفة أو المجموعة أو اللائحة التي استُدعيت عبرها، وفي حال تمرير شرط منطقيpredicate كمعامل (parameter) فستعيد العنصر الوحيد الذي يحقق ذلك الشرط المنطقي. أمّا في حال كان الكائن الذي استُدعيت عبره يحتوي أكثر من عنصر واحد (يحقق predicate في حال تمريرها) أو لا يحتوي أي واحد (يحقق predicate في حال تمريرها) فستعيد القيمة المعدومة null.
slice
تعيد الدالةslice()لائحة تحتوي عناصر المصفوفة أو اللائحة التي استُدعيت عبرها والموجودة عند الفهارس التي يحددها الوسيط الممرّر indices.
sliceArray
تعيد الدالةsliceArray()لائحة أو مصفوفة تحتوي عناصر المصفوفة التي استُدعيت عبرها والموجودة عند الفهارس التي يحددها الوسيط الممرّرindices.
sortedBy
تعيد الدالةsortedBy() لائحة تضم عناصر المصفوفة أو اللائحة المتغيرة (MutableList) التي استُدعيت عبرها مرتبة وفقًا للقيم التي تعيدها الدالة المُمرّرة selector.
sortedByDescending
تعيد الدالةsortedByDescending() لائحة تضم عناصر المصفوفة أو اللائحة المتغيرة (MutableList) التي استُدعيت عبرها مرتبة ترتيبًا تنازليًا وفقًا للقيم التي تعيدها الدالة المُمرّرة selector.
sortedWith
تعيد الدالةsortedWith() لائحة تضم عناصر المصفوفة أو المجموعة التكرارية التي استُدعيت عبرها مرتبة وفق المُقارِن المُمرّر comparator.
subtract
تعيد الدالةsubtract() مجموعة (Set) تضم عناصر المصفوفة أو المجموعة التكرارية التي استُدعيت عبرها والتي لا توجد في المجموعة المُمرّرة.
sumBy
تعيد الدالةsumBy() مجموع العناصر المُعادة من الدالة selector مطبقةً على عناصر المصفوفة أو المجموعة التي استُدعيت عبرها.
sumByDouble
تعيد الدالةsumByDouble() مجموع العناصر المُعادة من الدالة selector مطبقةً على عناصر المصفوفة أو المجموعة التي استُدعيت عبرها.
take
تعيد الدالةtake() لائحة تضم n من أولى العناصر الموجودة في المصفوفة أو المجموعة التكرارية التي استُدعيت عبرها.
takeLast
تعيد الدالةtakeLast() لائحة تضم آخر n من العناصر الموجودة في المصفوفة أو المجموعة التكرارية التي استُدعيت عبرها.
takeLa
تعيد الدالةtakeLastWhile() لائحة تضم آخر عناصر المصفوفة أو اللائحة التي استُدعيت عبرها والتي تحقق الشرط المنطقي المُمرّر predicate.stWhile
takeWhile
تعيد الدالةtakeWhile() لائحة تضم أولى عناصر المصفوفة أو المجموعة التكرارية التي استُدعيت عبرها والتي تحقق الشرط المنطقي المُمرّرpredicate.
toCollection
تضيف الدالةtoCollection() عناصر المصفوفة أو المجموعة التي استُدعيت عبرها إلى المجموعة المتغيرة (MutableCollection) المُمرّرةdestination.
toHashSet
تعيد الدالةtoHashSet() كائنًا من النوع HashSetيضم جميع عناصر المصفوفة أو المجموعة التي استُدعيت عبرها.
toList
تعيد الدالةtoList() لائحة تضم جميع عناصر المصفوفة أو المجموعة التكرارية التي استُدعيت عبرها. وفي حال استدعاء الدالةtoList() عبر قاموسفستعيد لائحة تضم جميع الأزواج مفتاح/قيمة المنتمية إليه.
toMutableList
تعيد الدالةtoMutableList() لائحة متغيرة تضم جميع عناصر المصفوف أو المجموعة التي استُدعيت عبرها.
toMutableSet
تعيد الدالةtoMutableSet() مجموعة من النوع MutableSet تضم جميع عناصر المصفوفة أو المجموعة التكرارية التي استُدعيت عبرها بدون تكرار.
toSet
تعيد الدالةtoSet() مجموعة من النوع Set تضم جميع عناصر المصفوفة أو المجموعة التكرارية التي استُدعيت عبرها.
toSortedSet
تعيد الدالةtoSortedSet() مجموعة من النوع SortedSet تضم جميع عناصر المصفوفة أو المجموعة التكرارية التي استُدعيت عبرها. وفي حال تمرير دالة مقارنة comparator إلى الدالةtoSortedSet() فسترتب المجموعة المعادة حسب ذلك المقارِن.
union
تعيد الدالةunion() مجموعة من النوع Set تضم جميع عناصر المصفوفة أو المجموعة التكرارية التي استُدعيت عبرها والمجموعة التكرارية المُمرّرة.
withIndex
تعيد الدالةwithIndex() مجموعة تكرارية خاملة (lazy Iterable) من القيم المُفهرسة لكل عنصر من عناصر المصفوفة أو المجموعة التكرارية التي استُدعيت عبرها، وفي حال استدعائها عبر مُكرّر (Iterator) فستعيد مُكرّرا يغلّف كل عنصر مُنتج من ذلك المكرّر مع القيمة المُفهرسة.
zip
يختلف سلوك الدالةzip() بحسب إمضائها، أنظر فقرة البنية العامة لأجل التفاصيل.