الفرق بين المراجعتين لصفحة: «Kotlin/ByteArray»
< Kotlin
لا ملخص تعديل |
لا ملخص تعديل |
||
| سطر 1: | سطر 1: | ||
== الدوال البانية == | ==الدوال البانية== | ||
<code>[[Kotlin/ByteArray/Init|<int>]]</code> | <code>[[Kotlin/ByteArray/Init|<int>]]</code> | ||
ينشِئ التابع <code>ByteArray()</code> مصفوفةً من النوع <code>ByteArray</code> بحجم <code>size</code> مُحدَّدٍ، بحيث كل العناصر تساوي <code>0</code>، وفي حال تمرير دالة كوسيط فسيُحسَب كلُّ عنصرٍ فيها عبر استدعاء الدالة <code>init</code> المُحدَّدة، والتي تُعيد عنصرًا في المصفوفة بحسب الفهرس (index) المُعطى. | ينشِئ التابع <code>ByteArray()</code> مصفوفةً من النوع <code>ByteArray</code> بحجم <code>size</code> مُحدَّدٍ، بحيث كل العناصر تساوي <code>0</code>، وفي حال تمرير دالة كوسيط فسيُحسَب كلُّ عنصرٍ فيها عبر استدعاء الدالة <code>init</code> المُحدَّدة، والتي تُعيد عنصرًا في المصفوفة بحسب الفهرس (index) المُعطى. | ||
==الخاصيات== | |||
===<code>[[Kotlin/ByteArray/size|size]]</code>=== | |||
تعبِّر الخاصيّة <code>size</code> عن عدد العناصر الموجودة في المصفوفة (<code>ByteArray</code>). | |||
==الدوال== | |||
===<code>[[Kotlin/ByteArray/get|get]]</code>=== | |||
يعيد التابع <code>get()</code> قيمة العنصر في المصفوفة عند الفهرس (index) المُحدَّد، ويمكن أيضًا استدعاء هذا التابع باستخدام معامل الفهرسة (index operator) المتمثل بالقوسين <code>[]</code> بالشكل: | |||
===<code>[[Kotlin/ByteArray/iterator|iterator]]</code>=== | |||
يعيد التابع <code>iterator()</code> عنصرًا تكراريًّا (iterator) بهدف تكرار بنيةٍ (block) برمجيةٍ على كافّة عناصر المصفوفة. | |||
=== <code>[[Kotlin/ByteArray/ | |||
== | ===<code>[[Kotlin/ByteArray/set|set]]</code>=== | ||
يعين التابع <code>set()</code> قيمة العنصر في المصفوفة عند الفهرس (index) المُحدَّد، ويمكن أيضًا استدعاء هذا التابع باستخدام معامل الفهرسة (index operator) المتمثل بالقوسين <code>[]</code> بالشكل: | |||
== الدوال الموروثة== | == الدوال الموروثة== | ||
===<code>[[Kotlin/Any/equals|equals]]</code>=== | ===<code>[[Kotlin/Any/equals|equals]]</code>=== | ||
تبين الدالة <code>equals()</code> إذا ما كان الكائن المُمرّر إليها يساوي الكائن الذي استدعيت عبره. | تبين الدالة <code>equals()</code> إذا ما كان الكائن المُمرّر إليها يساوي الكائن الذي استدعيت عبره. | ||
===<code>[[Kotlin/Any/hashCode|hashCode]]</code>=== | ===<code>[[Kotlin/Any/hashCode|hashCode]]</code>=== | ||
يعيد التابع <code>hashCode()</code> قيمة الشيفرة hash code الخاصّة بالكائن الذي استُدعي عبره. | يعيد التابع <code>hashCode()</code> قيمة الشيفرة hash code الخاصّة بالكائن الذي استُدعي عبره. | ||
===<code>[[Kotlin/Any/toString|toString]]</code>=== | ===<code>[[Kotlin/Any/toString|toString]]</code>=== | ||
===يعيد التابع <code>toString()</code> تمثيلًا نصيًا للكائن الذي يُستدعى عبره.=== | ===يعيد التابع <code>toString()</code> تمثيلًا نصيًا للكائن الذي يُستدعى عبره.=== | ||
==الخاصيات الإضافية (Extension Properties)== | |||
===<code>[[Kotlin/collections/indices|indices]]</code>=== | |||
تُستخدَم هذه الخاصيّة للحصول على الفهارس الصحيحة (valid indices) للمصفوفة أو المجموعة (collection). | |||
===<code>[[Kotlin/collections/lastIndex|lastIndex]]</code>=== | |||
تُستخدَم هذه الخاصيّة للحصول على الفهرس (index) الأخير للمصفوفة أو القائمة (list)، أو القيمة <code>-1</code> إن كانت المصفوفة أو القائمة فارغةً. | |||
==الدوال الإضافية (Extension Functions)== | |||
===<code>[[Kotlin/collections/all|all]]</code>=== | |||
تُعيد الدالة <code>all()</code> القيمة <code>true</code> إن كانت كافّة عناصر المصفوفة أو المجموعة (collection) التي استُدعيت عبرها تحقق العبارة المنطقية (predicate) المُحدَّدة، أو تعيد القيمة <code>false</code> بخلاف ذلك. | |||
===<code>[[Kotlin/collections/any|any]]</code>=== | |||
يختلف سلوك الدالة <code>any()</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|a]]</code>=== | |||
===تُعيد الدالة <code>asList()</code> قائمةً (list) تُغلّف المصفوفة الأصلية التي استُدعيت عبرها.<code>[[Kotlin/collections/asList|sList]]</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>associate()</code> خريطةً (map) تحوي أزواجًا من "مفتاح/قيمة" ناتجة عن تمرير عناصر المصفوفة أو المجموعة ([[Kotlin/collections|Collection]]) إلى الدالة<code>()transform</code>. | |||
===<code>[[Kotlin/collections/associateBy|associateBy]]</code>=== | |||
تعيد الدالة <code>associateBy()</code> خريطةً (map) تحتوي على عناصر المصفوفة أو المجموعة ([[Kotlin/collections|Collection]]) المعطاة مفهرسةً بقيمة المفتاح المعاد من تمرير تلك العناصر إلى الدالة <code>valueTransform</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>associateTo()</code> خريطةً متغيرةً (mutable map) تحتوي على أزواج من "قيمة/مفتاح"، إذ القيمة هي عناصر المصفوفة أو المجموعة ([[Kotlin/collections|Collection]]) المعطاة، والمفتاح هو الناتج المعاد من تمرير تلك العناصر إلى الدالة <code>transform</code>. | |||
===<code>[[Kotlin/collections/average|average]]</code>=== | |||
تحسب الدالة <code>average()</code> متوسط (average) عناصر المصفوفة أو المجموعة ([[Kotlin/collections|Collection]]) المعطاة لها. | |||
===<code>[[Kotlin/collections/binarySearch|binarySearch]]</code>=== | |||
تبحث الدالة <code>binarySearch()</code> عن عنصر معين في المجموعة أو مجال من المجموعة ([[Kotlin/collections|Collection]]) باستخدام خوارزميَّة البحث الثنائي (binary search algorithm) وتعيد فهرس موقعه. ويجب أن تكون المجموعة مرتبَّةً وفق المُقارِن <code>comparator</code> وإلا فستكون النتيجة المعادة غير مُحدّدة. | |||
===<code>[[Kotlin/collections/component1|component1]]</code>=== | |||
تعيد الدالة <code>component1()</code> العنصر الأول من المصفوفة أو المفتاح (key) لأول زوج (مفتاح/قيمة) في الخريطة (map) التي استدعيت معها. تسمح هذه الدالة باستخدام التصريحات التفكيكية (destructuring declarations) عند العمل على الخرائط. | |||
===<code>[[Kotlin/collections/contains|contains]]</code>=== | |||
تتحقق الدالة <code>contains()</code> إن كانت <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت معها تحتوي على العنصر الممرّر إليها، أو إن كانت الخريطة التي استدعيت معها تحتوي على ذلك العنصر كمفتاح (key). | |||
===<code>[[Kotlin/collections/contentEquals|contentEquals]]</code>=== | |||
تتحقَّق الدالة <code>contentEquals()</code> من تساوي <nowiki/>[[Kotlin/Array|مصفوفتين]] بنيويًا (''structurally'' equal)، أي إن كان لهما نفس العناصر وبنفس العدد والترتيب. | |||
===<code>[[Kotlin/collections/contentHashCode|contentHashCode]]</code>=== | |||
تشفِّر الدالة <code>contentHashCode()</code> محتوى <nowiki/>[[Kotlin/Array|المصفوفة]] التي استُدعيت معها كما لو كانت قائمة إلى شيفرة Hash. | |||
===<code>[[Kotlin/collections/contentToString|contentToString]]</code>=== | |||
تعيد الدالة <code>contentToString()</code> سلسلة نصية تمثِّل محتوى <nowiki/>[[Kotlin/Array|المصفوفة]] التي استُدعيت معها كما لو كانت قائمة. | |||
===<code>[[Kotlin/collections/copyOf|copyOf]]</code>=== | |||
تنسخ الدالة <code>copyOf()</code> كامل <nowiki/>[[Kotlin/Array|المصفوفة]] التي استُدعيت معها أو جزءًا منها. | |||
===<code>[[Kotlin/collections/copyOfRange|copyOfRange]]</code>=== | |||
تنسخ الدالة <code>copyOfRange()</code> مجالًا محدَّدًا من <nowiki/>[[Kotlin/Array|المصفوفة]] التي استُدعيت معها. | |||
===<code>[[Kotlin/collections/count|count]]</code>=== | |||
تعيد الدالة <code>count()</code> عدد عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] أو الخريطة التي استُدعيت معها. يمكن تمرير دالة منطقية كمعامل إلى هذه الدالة لعد العناصر التي تحقق شرطًا معينًّا. | |||
===<code>[[Kotlin/collections/distinct|distinct]]</code>=== | |||
تحذف الدالة <code>distinct()</code> العناصر المتكررة الموجودة في <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت معها وتعيد الناتج في قائمة. تُرتَّب العناصر في القائمة الناتجة بنفس ترتيبها في المصفوفة أو المجموعة الأصليَّة. | |||
===<code>[[Kotlin/collections/distinctBy|distinctBy]]</code>=== | |||
تعيد الدالة <code>distinctBy()</code> قائمة تحتوي على العناصر الموجودة في <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/Array|المجموعة]] التي استُدعيت معها والتي تعطي نتيجة مختلفة عند تطبيق الدالة <code>selector</code> عليها فقط. تُرتَّب العناصر في القائمة الناتجة بنفس ترتيبها في المصفوفة أو المجموعة الأصليَّة. | |||
== | ===<code>[[Kotlin/collections/drop|drop]]</code>=== | ||
تعيد الدالة <code>drop()</code> قائمة تحوي جميع عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/Array|المجموعة]] التي استُدعيت معها باستثناء أول <code>n</code> عنصر. | |||
=== <code>[[Kotlin/collections/ | ===<code>[[Kotlin/collections/dropLast|dropLast]]</code>=== | ||
تعيد الدالة <code>dropLast()</code> قائمة تحوي جميع عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/Array|المجموعة]] التي استُدعيت معها باستثناء آخر <code>n</code> عنصر. | |||
== | ===<code>[[Kotlin/collections/dropLastWhile|dropLastWhile]]</code>=== | ||
تعيد الدالة <code>dropLastWhile()</code> قائمةً تحوي جميع عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت معها باستثناء العناصر الأخيرة التي تحقق شرطًا معيَّنًا. | |||
=== <code>[[Kotlin/collections/ | ===<code>[[Kotlin/collections/dropWhile|dropWhile]]</code>=== | ||
=== <code>[[Kotlin/collections/ | تعيد الدالة <code>dropLastWhile()</code> قائمةً تحوي جميع عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت معها باستثناء العناصر الأولى التي تحقق شرطًا معيَّنًا. | ||
=== <code>[[Kotlin/collections/ | |||
=== <code>[[Kotlin/collections/ | ===<code>[[Kotlin/collections/elementAt|elementAt]]</code>=== | ||
=== <code>[[Kotlin/collections/ | تجلب الدالة <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/ | |||
=== <code>[[Kotlin/collections/ | ===<code>[[Kotlin/collections/elementAtOrElse|elementAtOrElse]]</code>=== | ||
=== <code>[[Kotlin/collections/ | تجلب الدالة <code>elementAtOrElse()</code> عنصرًا ذي فهرس معيَّن من <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت معها. إن كان الفهرس المعطى خارج حدود<nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/Array|المجموعة]]، فستُعيد الدالة ناتج استدعاء دالة معينة. | ||
=== <code>[[Kotlin/collections/ | |||
=== <code>[[Kotlin/collections/ | ===<code>[[Kotlin/collections/elementAtOrNull|elementAtOrNull]]</code>=== | ||
=== <code>[[Kotlin/collections/ | تجلب الدالة <code>elementAtOrNull()</code> عنصرًا ذي فهرس معيَّن من <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت معها. إن كان الفهرس المعطى خارج حدود<nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/Array|المجموعة]]، فستُعيد الدالة القيمة العدمية <code>null</code>. | ||
=== <code>[[Kotlin/collections/ | |||
===<code>[[Kotlin/collections/fill|fill]]</code>=== | |||
تبدِّل الدالة <code>fill()</code> قيمة جديدة معطاة مكان عناصر محدَّدة في <nowiki/>[[Kotlin/Array|المصفوفة]] أو القائمة التي تستدعى معها. | |||
===<code>[[Kotlin/collections/filter|filter]]</code>=== | |||
ترشِّح الدالة <code>filter()</code> عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] أو أزواج الخرائط المعطاة التي تحقِّق شرطًا معيَّنًا ثمّ تعيدها. | |||
===<code>[[Kotlin/collections/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>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/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>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>find()</code> العنصر الأول من <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت عبرها والذي يحقق الشرط المنطقي <code>predicate</code> المُمرّر إليها. وإن لم يكن هناك أي عنصر يحقق ذلك فستعيد <code>null.</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/firstOrNull|firstOrNull]]</code>=== | |||
===<code>[[Kotlin/collections/flatMap|flatMap]]</code>=== | |||
===<code>[[Kotlin/collections/flatMapTo|flatMapTo]]</code>=== | |||
===<code>[[Kotlin/collections/fold|fold]]</code>=== | |||
===<code>[[Kotlin/collections/foldIndexed|foldIndexed]]</code>=== | |||
===<code>[[Kotlin/collections/foldRight|foldRight]]</code>=== | |||
===<code>[[Kotlin/collections/foldRightIndexed|foldRightIndexed]]</code>=== | |||
===<code>[[Kotlin/collections/forEach|forEach]]</code>=== | |||
===<code>[[Kotlin/collections/forEachIndexed|forEachIndexed]]</code>=== | |||
===<code>[[Kotlin/collections/getOrElse|getOrElse]]</code>=== | |||
===<code>[[Kotlin/collections/getOrNull|getOrNull]]</code>=== | |||
===<code>[[Kotlin/collections/groupBy|groupBy]]</code>=== | |||
===<code>[[Kotlin/collections/groupByTo|groupByTo]]</code>=== | |||
===<code>[[Kotlin/collections/indexOf|indexOf]]</code>=== | |||
===<code>[[Kotlin/collections/indexOfFirst|indexOfFirst]]</code>=== | |||
===<code>[[Kotlin/collections/indexOfLast|indexOfLast]]</code>=== | |||
#N/A | #N/A | ||
===<code>[[Kotlin/collections/intersect|intersect]]</code>=== | |||
===<code>[[Kotlin/collections/isEmpty|isEmpty]]</code>=== | |||
===<code>[[Kotlin/collections/isNotEmpty|isNotEmpty]]</code>=== | |||
===<code>[[Kotlin/collections/joinTo|joinTo]]</code>=== | |||
===<code>[[Kotlin/collections/joinToString|joinToString]]</code>=== | |||
===<code>[[Kotlin/collections/last|last]]</code>=== | |||
===<code>[[Kotlin/collections/lastIndexOf|lastIndexOf]]</code>=== | |||
===<code>[[Kotlin/collections/lastOrNull|lastOrNull]]</code>=== | |||
===<code>[[Kotlin/collections/map|map]]</code>=== | |||
===<code>[[Kotlin/collections/mapIndexed|mapIndexed]]</code>=== | |||
===<code>[[Kotlin/collections/mapIndexedTo|mapIndexedTo]]</code>=== | |||
===<code>[[Kotlin/collections/mapTo|mapTo]]</code>=== | |||
===<code>[[Kotlin/collections/max|max]]</code>=== | |||
===<code>[[Kotlin/collections/maxBy|maxBy]]</code>=== | |||
===<code>[[Kotlin/collections/maxWith|maxWith]]</code>=== | |||
===<code>[[Kotlin/collections/min|min]]</code>=== | |||
===<code>[[Kotlin/collections/minBy|minBy]]</code>=== | |||
===<code>[[Kotlin/collections/minWith|minWith]]</code>=== | |||
===<code>[[Kotlin/collections/none|none]]</code>=== | |||
===<code>[[Kotlin/collections/partition|partition]]</code>=== | |||
===<code>[[Kotlin/collections/plus|plus]]</code>=== | |||
===<code>[[Kotlin/collections/reduce|reduce]]</code>=== | |||
===<code>[[Kotlin/collections/reduceIndexed|reduceIndexed]]</code>=== | |||
===<code>[[Kotlin/collections/reduceRight|reduceRight]]</code>=== | |||
===<code>[[Kotlin/collections/reduceRightIndexed|reduceRightIndexed]]</code>=== | |||
===<code>[[Kotlin/collections/reverse|reverse]]</code>=== | |||
===<code>[[Kotlin/collections/reversed|reversed]]</code>=== | |||
===<code>[[Kotlin/collections/reversedArray|reversedArray]]</code>=== | |||
===<code>[[Kotlin/collections/single|single]]</code>=== | |||
===<code>[[Kotlin/collections/singleOrNull|singleOrNull]]</code>=== | |||
===<code>[[Kotlin/collections/slice|slice]]</code>=== | |||
===<code>[[Kotlin/collections/sliceArray|sliceArray]]</code>=== | |||
===<code>[[Kotlin/collections/sort|sort]]</code>=== | |||
===<code>[[Kotlin/collections/sortDescending|sortDescending]]</code>=== | |||
===<code>[[Kotlin/collections/sorted|sorted]]</code>=== | |||
===<code>[[Kotlin/collections/sortedArray|sortedArray]]</code>=== | |||
===<code>[[Kotlin/collections/sortedArrayDescending|sortedArrayDescending]]</code>=== | |||
===<code>[[Kotlin/collections/sortedBy|sortedBy]]</code>=== | |||
===<code>[[Kotlin/collections/sortedByDescending|sortedByDescending]]</code>=== | |||
===<code>[[Kotlin/collections/sortedDescending|sortedDescending]]</code>=== | |||
===<code>[[Kotlin/collections/sortedWith|sortedWith]]</code>=== | |||
===<code>[[Kotlin/collections/subtract|subtract]]</code>=== | |||
===<code>[[Kotlin/collections/sum|sum]]</code>=== | |||
===<code>[[Kotlin/collections/sumBy|sumBy]]</code>=== | |||
===<code>[[Kotlin/collections/sumByDouble|sumByDouble]]</code>=== | |||
===<code>[[Kotlin/collections/take|take]]</code>=== | |||
===<code>[[Kotlin/collections/takeLast|takeLast]]</code>=== | |||
===<code>[[Kotlin/collections/takeLastWhile|takeLastWhile]]</code>=== | |||
===<code>[[Kotlin/collections/takeWhile|takeWhile]]</code>=== | |||
===<code>[[Kotlin/collections/toCollection|toCollection]]</code>=== | |||
===<code>[[Kotlin/collections/toHashSet|toHashSet]]</code>=== | |||
===<code>[[Kotlin/collections/toList|toList]]</code>=== | |||
===<code>[[Kotlin/collections/toMutableList|toMutableList]]</code>=== | |||
===<code>[[Kotlin/collections/toMutableSet|toMutableSet]]</code>=== | |||
===<code>[[Kotlin/collections/toSet|toSet]]</code>=== | |||
===<code>[[Kotlin/collections/toSortedSet|toSortedSet]]</code>=== | |||
#N/A | #N/A | ||
#N/A | #N/A | ||
===<code>[[Kotlin/collections/union|union]]</code>=== | |||
===<code>[[Kotlin/collections/withIndex|withIndex]]</code>=== | |||
===<code>[[Kotlin/collections/zip|zip]]</code>=== | |||
=== <code>[[Kotlin/collections/union|union]]</code> === | |||
=== <code>[[Kotlin/collections/withIndex|withIndex]]</code> === | |||
=== <code>[[Kotlin/collections/zip|zip]]</code> === | |||
[[تصنيف:Kotlin]] | [[تصنيف:Kotlin]] | ||
[[تصنيف:Kotlin Classes]] | [[تصنيف:Kotlin Classes]] | ||
[[تصنيف:Kotlin ByteArray]] | [[تصنيف:Kotlin ByteArray]] | ||
مراجعة 12:01، 15 يوليو 2018
الدوال البانية
ينشِئ التابع ByteArray() مصفوفةً من النوع ByteArray بحجم size مُحدَّدٍ، بحيث كل العناصر تساوي 0، وفي حال تمرير دالة كوسيط فسيُحسَب كلُّ عنصرٍ فيها عبر استدعاء الدالة init المُحدَّدة، والتي تُعيد عنصرًا في المصفوفة بحسب الفهرس (index) المُعطى.
الخاصيات
size
تعبِّر الخاصيّة size عن عدد العناصر الموجودة في المصفوفة (ByteArray).
الدوال
get
يعيد التابع get() قيمة العنصر في المصفوفة عند الفهرس (index) المُحدَّد، ويمكن أيضًا استدعاء هذا التابع باستخدام معامل الفهرسة (index operator) المتمثل بالقوسين [] بالشكل:
iterator
يعيد التابع iterator() عنصرًا تكراريًّا (iterator) بهدف تكرار بنيةٍ (block) برمجيةٍ على كافّة عناصر المصفوفة.
set
يعين التابع set() قيمة العنصر في المصفوفة عند الفهرس (index) المُحدَّد، ويمكن أيضًا استدعاء هذا التابع باستخدام معامل الفهرسة (index operator) المتمثل بالقوسين [] بالشكل:
الدوال الموروثة
equals
تبين الدالة equals() إذا ما كان الكائن المُمرّر إليها يساوي الكائن الذي استدعيت عبره.
hashCode
يعيد التابع hashCode() قيمة الشيفرة hash code الخاصّة بالكائن الذي استُدعي عبره.
toString
يعيد التابع toString() تمثيلًا نصيًا للكائن الذي يُستدعى عبره.
الخاصيات الإضافية (Extension Properties)
indices
تُستخدَم هذه الخاصيّة للحصول على الفهارس الصحيحة (valid indices) للمصفوفة أو المجموعة (collection).
lastIndex
تُستخدَم هذه الخاصيّة للحصول على الفهرس (index) الأخير للمصفوفة أو القائمة (list)، أو القيمة -1 إن كانت المصفوفة أو القائمة فارغةً.
الدوال الإضافية (Extension Functions)
all
تُعيد الدالة all() القيمة true إن كانت كافّة عناصر المصفوفة أو المجموعة (collection) التي استُدعيت عبرها تحقق العبارة المنطقية (predicate) المُحدَّدة، أو تعيد القيمة false بخلاف ذلك.
any
يختلف سلوك الدالة any() بحسب طريقة استدعائها، وسنناقش هذه الحالات تباعًا.
asIterable
تُنشِئ الدالة asIterable()نسخةً تكراريّةً (iterable instance) تُغلّف (wrap) المصفوفة الأصلية وتعيد عناصرَها عندما تُستخدَم في حلقات التكرار (مثل for).
a
تُعيد الدالة asList() قائمةً (list) تُغلّف المصفوفة الأصلية التي استُدعيت عبرها.sList
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.
average
تحسب الدالة average() متوسط (average) عناصر المصفوفة أو المجموعة (Collection) المعطاة لها.
binarySearch
تبحث الدالة binarySearch() عن عنصر معين في المجموعة أو مجال من المجموعة (Collection) باستخدام خوارزميَّة البحث الثنائي (binary search algorithm) وتعيد فهرس موقعه. ويجب أن تكون المجموعة مرتبَّةً وفق المُقارِن comparator وإلا فستكون النتيجة المعادة غير مُحدّدة.
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
filterNotTo
تضيف الدالةfilterNotTo() إلى المعامل destination الممرّر إليها عناصرّ المصفوفة أو المجموعة التي استُدعيت عبرها والتي لا تحقق الشرط المنطقي predicate المُمرّر إليها. من الجدير بالذكر أنّ destination ينبغي أن تكون مجموعة قابلة للتغيير (MutableCollection).
filterTo
تضيف الدالةfilterTo() إلى المعامل destination الممرّر إليها عناصرّ المصفوفة أو المجموعة التي استُدعيت عبرها والتي تحقق الشرط المنطقيpredicate المُمرّر إليها. من الجدير بالذكر أنّ destination ينبغي أن تكون مجموعة قابلة للتغيير (MutableCollection).
find
تعيد الدالةfind() العنصر الأول من المصفوفة أو المجموعة التي استُدعيت عبرها والذي يحقق الشرط المنطقي predicate المُمرّر إليها. وإن لم يكن هناك أي عنصر يحقق ذلك فستعيد null.
findLast
تعيد الدالةfindLast() العنصر الأخير من المصفوفة أو المجموعة التي استُدعيت عبرها والذي يحقق الشرط المنطقي predicate المُمرّر إليها. وإن لم يكن هناك أي عنصر يحقق ذلك فستعيد null.
first
firstOrNull
flatMap
flatMapTo
fold
foldIndexed
foldRight
foldRightIndexed
forEach
forEachIndexed
getOrElse
getOrNull
groupBy
groupByTo
indexOf
indexOfFirst
indexOfLast
- N/A
intersect
isEmpty
isNotEmpty
joinTo
joinToString
last
lastIndexOf
lastOrNull
map
mapIndexed
mapIndexedTo
mapTo
max
maxBy
maxWith
min
minBy
minWith
none
partition
plus
reduce
reduceIndexed
reduceRight
reduceRightIndexed
reverse
reversed
reversedArray
single
singleOrNull
slice
sliceArray
sort
sortDescending
sorted
sortedArray
sortedArrayDescending
sortedBy
sortedByDescending
sortedDescending
sortedWith
subtract
sum
sumBy
sumByDouble
take
takeLast
takeLastWhile
takeWhile
toCollection
toHashSet
toList
toMutableList
toMutableSet
toSet
toSortedSet
- N/A
- N/A