الفرق بين المراجعتين لصفحة: «Kotlin/BooleanArray»
لا ملخص تعديل |
|||
| سطر 1: | سطر 1: | ||
== الدوال البانية == | |||
[[Kotlin/BooleanArray/Init|init]] | |||
يعيد التابع <code>BooleanArray()</code> <nowiki/>[[Kotlin/Array|مصفوفة]] حجمها هو المعامل المُمرّر <code>size،</code> بحيث أنّ كل عنصر منها يُحسب باستدعاء الدالة المُمرّرة <code>init</code> على قيمة الفهرس الحالي. في حال تمرير الوسيط <code>size</code> فقط فكل القيم ستساوي <code>false</code>. | |||
== الخاصيات == | |||
=== <code>[[Kotlin/BooleanArray/size|size]]</code> === | === <code>[[Kotlin/BooleanArray/size|size]]</code> === | ||
تعبِّر الخاصيّة <code>size</code> عن عدد العناصر الموجودة في المصفوفة. | |||
== الدوال == | |||
=== <code>[[Kotlin/BooleanArray/get|get]]</code> === | === <code>[[Kotlin/BooleanArray/get|get]]</code> === | ||
يعيد التابع <code>get()</code> قيمة العنصر في المصفوفة عند الفهرس (index) المُحدَّد. | |||
=== <code>[[Kotlin/BooleanArray/iterator|iterator]]</code> === | === <code>[[Kotlin/BooleanArray/iterator|iterator]]</code> === | ||
يعيد التابع <code>iterator()</code> عنصرًا تكراريًّا (iterator) بهدف تكرار بنيةٍ (block) برمجيةٍ على كافّة عناصر المصفوفة. | |||
=== <code>[[Kotlin/BooleanArray/set|set]]</code> === | === <code>[[Kotlin/BooleanArray/set|set]]</code> === | ||
يُعيِّن التابع <code>set()</code> قيمة العنصر في المصفوفة عند الفهرس (index) المُحدَّد، كما يمكن أيضًا استدعاء هذا التابع باستخدام الإسناد (assignment) ومعامل الفهرسة (index operator) بالشكل: | |||
== الدوال الموروثة == | |||
=== <code>[[Kotlin/Any/equals|equals]]</code> === | === <code>[[Kotlin/Any/equals|equals]]</code> === | ||
تبين الدالة <code>equals()</code> إذا ما كان الكائن المُمرّر إليها يساوي الكائن الذي استدعيت عبره. | |||
=== <code>[[Kotlin/Any/hashCode|hashCode]]</code> === | === <code>[[Kotlin/Any/hashCode|hashCode]]</code> === | ||
يعيد التابع <code>hashCode()</code> قيمة الشيفرة hash code الخاصّة بالكائن الذي استُدعي عبره. | |||
=== <code>[[Kotlin/Any/toString|toString]]</code> === | === <code>[[Kotlin/Any/toString|toString]]</code> === | ||
يعيد التابع <code>toString()</code> تمثيلًا نصيًا للكائن الذي يُستدعى عبره. | |||
== الخاصيات الإضافية (Extension Properties) == | |||
=== <code>[[Kotlin/collections/indices|indices]]</code> === | === <code>[[Kotlin/collections/indices|indices]]</code> === | ||
تُستخدَم هذه الخاصيّة للحصول على الفهارس الصحيحة (valid indices) للمصفوفة أو المجموعة (collection). | |||
=== <code>[[Kotlin/collections/lastIndex|lastIndex]]</code> === | === <code>[[Kotlin/collections/lastIndex|lastIndex]]</code> === | ||
[[Kotlin/collections/lastIndex]] | |||
== الدوال الإضافية (Extension Functions) == | |||
=== <code>[[Kotlin/collections/all|all]]</code> === | === <code>[[Kotlin/collections/all|all]]</code> === | ||
تُعيد الدالة <code>all()</code> القيمة <code>true</code> إن كانت كافّة عناصر المصفوفة أو المجموعة (collection) التي استُدعيت عبرها تحقق العبارة المنطقية (predicate) المُحدَّدة، أو تعيد القيمة <code>false</code> بخلاف ذلك. | |||
=== <code>[[Kotlin/collections/any|any]]</code> === | === <code>[[Kotlin/collections/any|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>[[Kotlin/collections/asList|asList]]</code> === | ||
تُعيد الدالة <code>asList()</code> قائمةً (list) تُغلّف المصفوفة الأصلية التي استُدعيت عبرها. | |||
=== <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>[[Kotlin/collections/associate|associate]]</code> === | === <code>[[Kotlin/collections/associate|associate]]</code> === | ||
تعيد الدالة <code>associate()</code> خريطةً (map) تحوي أزواجًا من "مفتاح/قيمة" ناتجة عن تمرير عناصر المصفوفة أو المجموعة ([[Kotlin/collections|Collection]]) إلى الدالة<code>()transform</code>. | |||
=== <code>[[Kotlin/collections/associateBy|associateBy]]</code> === | === <code>[[Kotlin/collections/associateBy|associateBy]]</code> === | ||
تعيد الدالة <code>associateBy()</code> خريطةً (map) تحتوي على عناصر المصفوفة أو المجموعة ([[Kotlin/collections|Collection]]) المعطاة مفهرسةً بقيمة المفتاح المعاد من تمرير تلك العناصر إلى الدالة <code>valueTransform</code>. | |||
=== <code>[[Kotlin/collections/associateByTo|associateByTo]]</code> === | === <code>[[Kotlin/collections/associateByTo|associateByTo]]</code> === | ||
تعيد الدالة <code>associateByTo()</code> خريطةً متغيرةً (mutable map) تحتوي على أزواج من "قيمة/مفتاح"، إذ القيمة هي عناصر المصفوفة أو المجموعة ([[Kotlin/collections|Collection]]) المعطاة، والمفتاح هو الناتج المعاد من تمرير تلك العناصر إلى الدالة <code>keySelector</code>. | |||
=== <code>[[Kotlin/collections/associateTo|associateTo]]</code> === | === <code>[[Kotlin/collections/associateTo|associateTo]]</code> === | ||
تعيد الدالة <code>associateTo()</code> خريطةً متغيرةً (mutable map) تحتوي على أزواج من "قيمة/مفتاح"، إذ القيمة هي عناصر المصفوفة أو المجموعة ([[Kotlin/collections|Collection]]) المعطاة، والمفتاح هو الناتج المعاد من تمرير تلك العناصر إلى الدالة <code>transform</code>. | |||
=== <code>[[Kotlin/collections/component1|component1]]</code> === | === <code>[[Kotlin/collections/component1|component1]]</code> === | ||
تعيد الدالة <code>component1()</code> العنصر الأول من المصفوفة أو المفتاح (key) لأول زوج (مفتاح/قيمة) في الخريطة (map) التي استدعيت معها. تسمح هذه الدالة باستخدام التصريحات التفكيكية (destructuring declarations) عند العمل على الخرائط. | |||
=== <code>[[Kotlin/collections/contains|contains]]</code> === | === <code>[[Kotlin/collections/contains|contains]]</code> === | ||
تتحقق الدالة <code>contains()</code> إن كانت <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت معها تحتوي على العنصر الممرّر إليها، أو إن كانت الخريطة التي استدعيت معها تحتوي على ذلك العنصر كمفتاح (key). | |||
=== <code>[[Kotlin/collections/contentEquals|contentEquals]]</code> === | === <code>[[Kotlin/collections/contentEquals|contentEquals]]</code> === | ||
تتحقَّق الدالة <code>contentEquals()</code> من تساوي <nowiki/>[[Kotlin/Array|مصفوفتين]] بنيويًا (''structurally'' equal)، أي إن كان لهما نفس العناصر وبنفس العدد والترتيب. | |||
=== <code>[[Kotlin/collections/contentHashCode|contentHashCode]]</code> === | === <code>[[Kotlin/collections/contentHashCode|contentHashCode]]</code> === | ||
تشفِّر الدالة <code>contentHashCode()</code> محتوى <nowiki/>[[Kotlin/Array|المصفوفة]] التي استُدعيت معها كما لو كانت قائمة إلى شيفرة Hash. | |||
=== <code>[[Kotlin/collections/contentToString|contentToString]]</code> === | === <code>[[Kotlin/collections/contentToString|contentToString]]</code> === | ||
تعيد الدالة <code>contentToString()</code> سلسلة نصية تمثِّل محتوى <nowiki/>[[Kotlin/Array|المصفوفة]] التي استُدعيت معها كما لو كانت قائمة. | |||
=== <code>[[Kotlin/collections/copyOf|copyOf]]</code> === | === <code>[[Kotlin/collections/copyOf|copyOf]]</code> === | ||
تنسخ الدالة <code>copyOf()</code> كامل <nowiki/>[[Kotlin/Array|المصفوفة]] التي استُدعيت معها أو جزءًا منها. | |||
=== <code>[[Kotlin/collections/copyOfRange|copyOfRange]]</code> === | === <code>[[Kotlin/collections/copyOfRange|copyOfRange]]</code> === | ||
تنسخ الدالة <code>copyOfRange()</code> مجالًا محدَّدًا من <nowiki/>[[Kotlin/Array|المصفوفة]] التي استُدعيت معها. | |||
=== <code>[[Kotlin/collections/count|count]]</code> === | === <code>[[Kotlin/collections/count|count]]</code> === | ||
تعيد الدالة <code>count()</code> عدد عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] أو الخريطة التي استُدعيت معها. يمكن تمرير دالة منطقية كمعامل إلى هذه الدالة لعد العناصر التي تحقق شرطًا معينًّا. | |||
=== <code>[[Kotlin/collections/distinct|distinct]]</code> === | === <code>[[Kotlin/collections/distinct|distinct]]</code> === | ||
تحذف الدالة <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>[[Kotlin/collections/drop|drop]]</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>[[Kotlin/collections/dropLast|dropLast]]</code> === | ||
تعيد الدالة <code>dropLast()</code> قائمة تحوي جميع عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/Array|المجموعة]] التي استُدعيت معها باستثناء آخر <code>n</code> عنصر. | |||
=== <code>[[Kotlin/collections/dropLastWhile|dropLastWhile]]</code> === | === <code>[[Kotlin/collections/dropLastWhile|dropLastWhile]]</code> === | ||
تعيد الدالة <code>dropLastWhile()</code> قائمةً تحوي جميع عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت معها باستثناء العناصر الأخيرة التي تحقق شرطًا معيَّنًا. | |||
=== <code>[[Kotlin/collections/dropWhile|dropWhile]]</code> === | === <code>[[Kotlin/collections/dropWhile|dropWhile]]</code> === | ||
تعيد الدالة <code>dropLastWhile()</code> قائمةً تحوي جميع عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت معها باستثناء العناصر الأولى التي تحقق شرطًا معيَّنًا. | |||
=== <code>[[Kotlin/collections/elementAt|elementAt]]</code> === | === <code>[[Kotlin/collections/elementAt|elementAt]]</code> === | ||
تجلب الدالة <code>elementAt()</code> عنصرًا ذي فهرس معيَّن من <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت معها. إن كان فهرس العنصر المعطى خارج حدود <nowiki/>[[Kotlin/Array|المصفوفة]]<nowiki/>أو <nowiki/>[[Kotlin/Array|المجموعة]]، فستُطلق الدالة <nowiki/>[[Kotlin/exceptions|الاستثناء]] [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-index-out-of-bounds-exception/index.html IndexOutOfBoundsException]. | |||
=== <code>[[Kotlin/collections/elementAtOrElse|elementAtOrElse]]</code> === | === <code>[[Kotlin/collections/elementAtOrElse|elementAtOrElse]]</code> === | ||
تجلب الدالة <code>elementAtOrElse()</code> عنصرًا ذي فهرس معيَّن من <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت معها. إن كان الفهرس المعطى خارج حدود<nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/Array|المجموعة]]، فستُعيد الدالة ناتج استدعاء دالة معينة. | |||
=== <code>[[Kotlin/collections/elementAtOrNull|elementAtOrNull]]</code> === | === <code>[[Kotlin/collections/elementAtOrNull|elementAtOrNull]]</code> === | ||
تجلب الدالة <code>elementAtOrNull()</code> عنصرًا ذي فهرس معيَّن من <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت معها. إن كان الفهرس المعطى خارج حدود<nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/Array|المجموعة]]، فستُعيد الدالة القيمة العدمية <code>null</code>. | |||
=== <code>[[Kotlin/collections/fill|fill]]</code> === | === <code>[[Kotlin/collections/fill|fill]]</code> === | ||
تبدِّل الدالة <code>fill()</code> قيمة جديدة معطاة مكان عناصر محدَّدة في <nowiki/>[[Kotlin/Array|المصفوفة]] أو القائمة التي تستدعى معها. | |||
=== <code>[[Kotlin/collections/filter|filter]]</code> === | === <code>[[Kotlin/collections/filter|filter]]</code> === | ||
ترشِّح الدالة <code>filter()</code> عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] أو أزواج الخرائط المعطاة التي تحقِّق شرطًا معيَّنًا ثمّ تعيدها. | |||
=== <code>[[Kotlin/collections/filterIndexed|filterIndexed]]</code> === | === <code>[[Kotlin/collections/filterIndexed|filterIndexed]]</code> === | ||
ترشِّح الدالة <code>filterIndexed()</code> عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] المعطاة التي أعيدت القيمة <code>true</code> معها عند تطبيق الدالة <code>predicate()</code> المُمرّر عليها، إذ يمرَّر فهرس كل عنصر وقيمته إلى الدالة <code>predicate()</code> ثم تعيد بدورها قيمة منطقيَّة. | |||
=== <code>[[Kotlin/collections/filterIndexedTo|filterIndexedTo]]</code> === | === <code>[[Kotlin/collections/filterIndexedTo|filterIndexedTo]]</code> === | ||
تضيف الدالة <code>filterIndexedTo()</code> إلى المجموعة المتغيرة <code>destination</code> المُمرَّر إليها عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] المعطاة التي أعيدت القيمة <code>true</code> مع كل عنصر منها عند تطبيق الدالة <code>predicate()</code> المُمرّر عليها. يمرَّر فهرس كل عنصر وقيمته إلى الدالة <code>predicate()</code> ثم تعيد بدورها قيمة منطقيَّة. | |||
=== <code>[[Kotlin/collections/filterNot|filterNot]]</code> === | === <code>[[Kotlin/collections/filterNot|filterNot]]</code> === | ||
تعيد الدالة<code>filterNot()</code> <nowiki/>[[Kotlin/Array|لائحة]] تحتوي عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي لا تحقق الشرط المنطقي <code>predicate()</code> المُمرّر إلى الدالة. وفي حال استدعائها عبر قاموس فستعيد قاموسًا جديدًا مكونًا من كل الأزوج التي لا تحقق الشرط المنطقي <code>predicate()</code> الممرر إلى الدالة، هذا القاموسالجديد يحافظ على ترتيب تكرار (entry iteration order) القاموسالأصلي. | |||
=== <code>[[Kotlin/collections/filterNotTo|filterNotTo]]</code> === | === <code>[[Kotlin/collections/filterNotTo|filterNotTo]]</code> === | ||
تضيف الدالة<code>filterNotTo()</code> إلى المعامل <code>destination</code> الممرّر إليها عناصرّ <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت عبرها والتي لا تحقق الشرط المنطقي <code>predicate</code> المُمرّر إليها. من الجدير بالذكر أنّ <code>destination</code> ينبغي أن تكون <nowiki/>[[Kotlin/collections|مجموعة]] قابلة للتغيير (<code>MutableCollection</code>). | |||
=== <code>[[Kotlin/collections/filterTo|filterTo]]</code> === | === <code>[[Kotlin/collections/filterTo|filterTo]]</code> === | ||
تضيف الدالة<code>filterTo()</code> إلى المعامل <code>destination</code> الممرّر إليها عناصرّ <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت عبرها والتي تحقق الشرط المنطقي<code>predicate</code> المُمرّر إليها. من الجدير بالذكر أنّ <code>destination</code> ينبغي أن تكون <nowiki/>[[Kotlin/collections|مجموعة]] قابلة للتغيير (<code>MutableCollection</code>). | |||
=== <code>[[Kotlin/collections/find|find]]</code> === | === <code>[[Kotlin/collections/find|find]]</code> === | ||
تعيد الدالة<code>find()</code> العنصر الأول من <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت عبرها والذي يحقق الشرط المنطقي <code>predicate</code> المُمرّر إليها. وإن لم يكن هناك أي عنصر يحقق ذلك فستعيد <code>null.</code> | |||
=== <code>[[Kotlin/collections/findLast|findLast]]</code> === | === <code>[[Kotlin/collections/findLast|findLast]]</code> === | ||
تعيد الدالة<code>findLast()</code> العنصر الأخير من <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت عبرها والذي يحقق الشرط المنطقي <code>predicate</code> المُمرّر إليها. وإن لم يكن هناك أي عنصر يحقق ذلك فستعيد <code>null.</code> | |||
=== <code>[[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> لائحة تضم ناتج تطبيق الدالة <code>transform()</code> المُمرّرة إليها على عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت عبرها، وفي حال استدعاء الدالة <code>flatMap()</code> على قاموس فستعيد لائحة تضم ناتج تطبيق الدالة <code>transform()</code> على مداخل (entries) القاموس. | |||
=== <code>[[Kotlin/collections/flatMapTo|flatMapTo]]</code> === | === <code>[[Kotlin/collections/flatMapTo|flatMapTo]]</code> === | ||
تضيف الدالة<code>flatMapTo()</code> إلى اللائحة المُتغيرة (<code>MutableCollection</code>) <code>destination</code>المُمرّرة إليها ناتج تطبيق الدالة <code>transform()</code> على عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت عبرها، وفي حال استدعاء الدالة <code>flatMapTo()</code> على قاموس فستضيف إلى اللائحة <code>destination</code> ناتج تطبيق الدالة <code>transform()</code> على مداخل (entries) القاموس. | |||
=== <code>[[Kotlin/collections/fold|fold]]</code> === | === <code>[[Kotlin/collections/fold|fold]]</code> === | ||
يختلف سلوك الدالة<code>fold()</code> حسب نوع الكائنات التي استُدعيت عبرها و نوع المعاملات (parameters) المُمرّرة إليها (انظر فقرة <nowiki/>[[Kotlin/collections/fold#.D8.A7.D9.84.D8.A8.D9.86.D9.8A.D8.A9 .D8.A7.D9.84.D8.B9.D8.A7.D9.85.D8.A9|البنية العامة]]). | |||
=== <code>[[Kotlin/collections/foldIndexed|foldIndexed]]</code> === | === <code>[[Kotlin/collections/foldIndexed|foldIndexed]]</code> === | ||
تُراكِم الدالة<code>foldIndexed()</code> القيم بدءًا من القيمة المُمرّرة <code>initial</code> وتطبّق العملية <code>operation</code> من اليسار إلى اليمين على القيمة المُتراكمة الراهنة وعلى العنصر التالي من <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت عبرها وكذلك فهرسه. وتُعيد القيمة النهائية. | |||
=== <code>[[Kotlin/collections/foldRight|foldRight]]</code> === | === <code>[[Kotlin/collections/foldRight|foldRight]]</code> === | ||
تُراكِم الدالة<code>foldRight()</code> القيم بدءًا من القيمة المُمرّرة <code>initial</code> وتطبّق العملية <code>operation</code> من اليمين إلى اليسار على القيمة المُتراكمة الراهنة وعلى العنصر التالي من <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت عبرها. وتُعيد القيمة النهائية. | |||
=== <code>[[Kotlin/collections/foldRightIndexed|foldRightIndexed]]</code> === | === <code>[[Kotlin/collections/foldRightIndexed|foldRightIndexed]]</code> === | ||
تُراكِم الدالة<code>foldRightIndexed()</code> القيم بدءًا من القيمة المُمرّرة <code>initial</code> وتطبّق العملية <code>operation</code> من اليمين إلى اليسار على القيمة المُتراكمة الراهنة وعلى العنصر التالي من <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت عبرها وكذلك فهرسه. وتُعيد القيمة النهائية. | |||
=== <code>[[Kotlin/collections/forEach|forEach]]</code> === | === <code>[[Kotlin/collections/forEach|forEach]]</code> === | ||
تُنفّد الدالةُ<code>forEach()</code> الدالةَ المُمرّرةَ <code>action</code> على كل عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] أو القاموس الذي استُدعيت عبره. | |||
=== <code>[[Kotlin/collections/forEachIndexed|forEachIndexed]]</code> === | === <code>[[Kotlin/collections/forEachIndexed|forEachIndexed]]</code> === | ||
تُنفّد الدالةُ<code>forEachIndexed()</code> الدالةَ المُمرّرةَ <code>action</code> على كل عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] أو القاموس الذي استُدعيت عبره وعلى فهارسها (indices). | |||
=== <code>[[Kotlin/collections/getOrElse|getOrElse]]</code> === | === <code>[[Kotlin/collections/getOrElse|getOrElse]]</code> === | ||
تعيد الدالة <code>getOrElse()</code> قيمة العنصر عند الفهرس <code>index</code> المُحدَّد في <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت عبرها. ، أو نتيجة استدعاء الدالة المُمرّرة <code>defaultValue</code> إن كان الفهرس خارج الحدود. | |||
=== <code>[[Kotlin/collections/getOrNull|getOrNull]]</code> === | === <code>[[Kotlin/collections/getOrNull|getOrNull]]</code> === | ||
تعيد الدالة <code>getOrNull()</code> قيمة العنصر عند الفهرس <code>index</code> المُحدَّد في <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت عبرها. ، أو <code>null</code> إن كان الفهرس خارج الحدود. | |||
=== <code>[[Kotlin/collections/groupBy|groupBy]]</code> === | === <code>[[Kotlin/collections/groupBy|groupBy]]</code> === | ||
تعيد الدالة<code>groupBy()</code> قاموسًا يُجمّع عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت عبرها حيث مفاتيحه تعيدها الدالة المُمرّرة <code>keySelector</code> وقيمه لوائحُ تضم عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] (أو ناتج تمرير عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] على الدالة <code>valueTransform</code> في حال تمريرها). | |||
=== <code>[[Kotlin/collections/groupByTo|groupByTo]]</code> === | === <code>[[Kotlin/collections/groupByTo|groupByTo]]</code> === | ||
تجمّع الدالة<code>groupByTo()</code> عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت عبرها وتضيفها إلى القاموس.المُمرّر <code>destination</code> حيث مفاتيحه تعيدها الدالة الممرّرة <code>keySelector()</code> مُطبّقة على كل عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]]، وقيمُه لوائح تضم العناصر المقابلة، وفي حال تمرير معامل ثالث<code>valueTransform</code> فإنّ القيم ستكون لوائح تضم ناتج تطبيق الدالة <code>valueTransform</code> على العناصر المقابلة . ثم تعيد القاموس<code>destination.</code> | |||
=== <code>[[Kotlin/collections/indexOf|indexOf]]</code> === | === <code>[[Kotlin/collections/indexOf|indexOf]]</code> === | ||
تعيد الدالة <code>indexOf()</code> فهرس أول ظهور للعنصر المُمرّر إليها في <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] أو اللائحة التي استُدعيت عبرها ، أو <code>-1</code> إن كان العنصر المُمرّر غير موجود. | |||
=== <code>[[Kotlin/collections/indexOfFirst|indexOfFirst]]</code> === | === <code>[[Kotlin/collections/indexOfFirst|indexOfFirst]]</code> === | ||
=== <code>[[Kotlin/collections/indexOfLast|indexOfLast]]</code> === | === <code>[[Kotlin/collections/indexOfLast|indexOfLast]]</code> === | ||
تعيد الدالة <code>indexOfLast()</code> فهرس آخر ظهور للعنصر المُمرّر إليها في <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] أو اللائحة التي استُدعيت عبرها والذي يحقق الشرط المنطقي المُمرّر <code>predicate</code>، أو <code>-1</code> إن لم يكن هناك أي عنصر يحقق ذلك. | |||
=== <code>[[Kotlin/collections/intersect|intersect]]</code> === | === <code>[[Kotlin/collections/intersect|intersect]]</code> === | ||
تعيد الدالة <code>intersect()</code>مجموعة تحتوي كل العناصر المشتركة بين <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت عبرها وتلك الممرّرة إلى الدالة. | |||
=== <code>[[Kotlin/collections/isEmpty|isEmpty]]</code> === | === <code>[[Kotlin/collections/isEmpty|isEmpty]]</code> === | ||
تعيد الدالة <code>isEmpty()</code> القيمة <code>true</code> إن كانت <nowiki/>[[Kotlin/Array|المصفوفة]] التي استُدعيت عبرها فارغةً. | |||
=== <code>[[Kotlin/collections/isNotEmpty|isNotEmpty]]</code> === | === <code>[[Kotlin/collections/isNotEmpty|isNotEmpty]]</code> === | ||
تعيد الدالة <code>isNotEmpty()</code> القيمة <code>true</code> إن كانت <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت عبرها غير فارغةً. | |||
=== <code>[[Kotlin/collections/joinTo|joinTo]]</code> === | === <code>[[Kotlin/collections/joinTo|joinTo]]</code> === | ||
تجمّع الدالة<code>joinTo()</code> سلسة نصية من عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت عبرها مفصولة بالمعامل المُمرّر <code>separator</code> وباستخدام البادئة<code>prefix</code> واللاحقة <code>postfix</code> في حال تمريرهما، | |||
=== <code>[[Kotlin/collections/joinToString|joinToString]]</code> === | === <code>[[Kotlin/collections/joinToString|joinToString]]</code> === | ||
=== <code>[[Kotlin/collections/last|last]]</code> === | === <code>[[Kotlin/collections/last|last]]</code> === | ||
مراجعة 11:13، 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
last
lastIndexOf
lastOrNull
map
mapIndexed
mapIndexedTo
mapTo
maxBy
maxWith
minBy
minWith
none
partition
plus
reduce
reduceIndexed
reduceRight
reduceRightIndexed
reverse
reversed
reversedArray
single
singleOrNull
slice
sliceArray
sortedBy
sortedByDescending
sortedWith
subtract
sumBy
sumByDouble
take
takeLast
takeLastWhile
takeWhile
toCollection
toHashSet
toList
toMutableList
toMutableSet
toSet
toSortedSet
- N/A
union
withIndex
zip
- N/A
- N/A
- N/A
- N/A
- N/A
- N/A
- N/A
- N/A
- N/A
- N/A
- N/A
- N/A
- N/A
- N/A
- N/A
- N/A
- N/A
- N/A
- N/A
- N/A
- N/A
- N/A