الفرق بين المراجعتين لصفحة: «Kotlin/Byte»
لا ملخص تعديل |
لا ملخص تعديل |
||
سطر 2: | سطر 2: | ||
=== [[Kotlin/Byte/compareTo|compareTo]] === | === [[Kotlin/Byte/compareTo|compareTo]] === | ||
<noinclude>{{DISPLAYTITLE:الصنف <code>Byte</code> في Kotlin}}</noinclude> | تقارن الدالة<code>compareTo()</code> بين قيمة العنصر الذي استُدعيت عبره والقيمة المُمرّرة، إذ تعيد القيمة <code>0</code> إن كانا متساويين، أو تعيد قيمة سلبية إن كانت قيمة العنصر الذي استُدعيت عبره أصغر من القيمة المُمرّرة، أو تعيد قيمة موجبة إن كانت قيمة العنصر الذي استُدعيت عبره أكبر من القيمة المُمرّرة .<noinclude>{{DISPLAYTITLE:الصنف <code>Byte</code> في Kotlin}}</noinclude> | ||
=== <code>[[Kotlin/Byte/dec|dec]]</code> === | === <code>[[Kotlin/Byte/dec|dec]]</code> === | ||
تخفض الدالة<code>dec()</code> قيمة العدد الذي استُدعيت عبره بواحد ثم تعيد القيمة الناتجة. | |||
=== <code>[[Kotlin/Byte/div|div]]</code> === | === <code>[[Kotlin/Byte/div|div]]</code> === | ||
تقوم الدالة<code>div()</code> بقسمة العدد الذي استُدعيت عبره على العدد الممرّر. | |||
=== <code>[[Kotlin/Byte/inc|inc]]</code> === | === <code>[[Kotlin/Byte/inc|inc]]</code> === | ||
ترفع الدالة<code>inc()</code> قيمة العدد الذي استُدعيت عبره بواحد ثم تعيد القيمة الناتجة. | |||
=== <code>[[Kotlin/Byte/minus|minus]]</code> === | === <code>[[Kotlin/Byte/minus|minus]]</code> === | ||
تقوم الدالة<code>minus()</code> بطرح العدد الممرّر من العدد الذي استُدعيت عبره. | |||
=== <code>[[Kotlin/Byte/plus|plus]]</code> === | === <code>[[Kotlin/Byte/plus|plus]]</code> === | ||
تقوم الدالة<code>plus()</code> بإضافة العدد الممرّر إلى العدد الذي استُدعيت عبره. | |||
=== <code>[[Kotlin/Byte/rangeTo|rangeTo]]</code> === | === <code>[[Kotlin/Byte/rangeTo|rangeTo]]</code> === | ||
تنشئ الدالة<code>rangeTo()</code> مجالًا من العنصر الذي استُدعيت عبره إلى القيمة المُمرّرة. | |||
=== <code>[[Kotlin/Byte/rem|rem]]</code> === | === <code>[[Kotlin/Byte/rem|rem]]</code> === | ||
تحسب الدالة<code>rem()</code> باقي عملية قسمة العدد الذي استُدعيت عبره على العدد الممرّر إليها. | |||
=== <code>[[Kotlin/Byte/times|times]]</code> === | === <code>[[Kotlin/Byte/times|times]]</code> === | ||
تقوم الدالة<code>times()</code> بحساب ضرب العدد الممرّر مع العدد الذي استُدعيت عبره. | |||
=== <code>[[Kotlin/Byte/toByte|toByte]]</code> === | === <code>[[Kotlin/Byte/toByte|toByte]]</code> === | ||
تحوّل الدالة<code>toByte()</code> قيمة العنصر الذي استُدعيت عبره إلى عدد من النوع <code>[[Kotlin/Byte/index|Byte]]</code>، والذي قد يعني أنه سيحسب بشكل تقريبي. | |||
=== <code>[[Kotlin/Byte/toChar|toChar]]</code> === | === <code>[[Kotlin/Byte/toChar|toChar]]</code> === | ||
تعيد الدالة<code>toChar()</code> الحرف المقابل للقيمة العددية للعنصر الذي استُدعيت عبره، مُقتطعة (truncated) إلى 16 بتة إن كان ضروريًا. | |||
=== <code>[[Kotlin/Byte/toDouble|toDouble]]</code> === | === <code>[[Kotlin/Byte/toDouble|toDouble]]</code> === | ||
تحول الدالة<code>toDouble()</code> قيمة العنصر الذي استُدعيت عبره إلى عدد من النوع <code>[[Kotlin/Double/index|Double]]</code>، والذي قد يعني أنه سيحسب بشكل تقريبي. | |||
=== <code>[[Kotlin/Byte/toFloat|toFloat]]</code> === | === <code>[[Kotlin/Byte/toFloat|toFloat]]</code> === | ||
تحول الدالة<code>toFloat()</code> قيمة العنصر الذي استُدعيت عبره إلى عدد من النوع <code>[[Kotlin/Float/index|Float]]</code>، والذي قد يعني أنه سيحسب بشكل تقريبي. | |||
=== <code>[[Kotlin/Byte/toInt|toInt]]</code> === | === <code>[[Kotlin/Byte/toInt|toInt]]</code> === | ||
تحول الدالة<code>toInt()</code> قيمة العنصر الذي استُدعيت عبره إلى عدد من النوع <code>int</code>، والذي قد يعني أنه سيحسب بشكل تقريبي. | |||
=== <code>[[Kotlin/Byte/toLong|toLong]]</code> === | === <code>[[Kotlin/Byte/toLong|toLong]]</code> === | ||
تحول الدالة<code>toLong()</code> قيمة العنصر الذي استُدعيت عبره إلى عدد من النوع <code>Long</code>، والذي قد يعني أنه سيحسب بشكل تقريبي. | |||
=== <code>[[Kotlin/Byte/toShort|toShort]]</code> === | === <code>[[Kotlin/Byte/toShort|toShort]]</code> === | ||
تحول الدالة<code>toShort()</code> قيمة العنصر الذي استُدعيت عبره إلى عدد من النوع <code>Short</code>، والذي قد يعني أنه سيحسب بشكل تقريبي. | |||
=== <code>[[Kotlin/Byte/unaryMinus|unaryMinus]]</code> === | === <code>[[Kotlin/Byte/unaryMinus|unaryMinus]]</code> === | ||
تعيد الدالة<code>unaryMinus()</code> سالب العدد الذي استُدعيت عبره. | |||
=== <code>[[Kotlin/Byte/unaryPlus|unaryPlus]]</code> === | === <code>[[Kotlin/Byte/unaryPlus|unaryPlus]]</code> === | ||
تعيد الدالة<code>unaryPlus()</code> العدد الذي استُدعيت عبره. | |||
== الخاصيات المصاحبة (Companion Object Properties) == | == الخاصيات المصاحبة (Companion Object Properties) == | ||
=== <code>[[Kotlin/Byte/MAX_VALUE|MAX_VALUE]]</code> === | === <code>[[Kotlin/Byte/MAX_VALUE|MAX_VALUE]]</code> === | ||
<code>MAX_VALUE</code> هي ثابتة تحتوي القيمة القصوى للنوع <code>[[Kotlin/Byte/index|Byte]]</code>. | |||
=== <code>[[Kotlin/Byte/MIN_VALUE|MIN_VALUE]]</code> === | === <code>[[Kotlin/Byte/MIN_VALUE|MIN_VALUE]]</code> === | ||
<code>MIN_VALUE</code> هي ثابتة تحتوي القيمة الدنيا للنوع <code>[[Kotlin/Byte/index|Byte]]</code>. | |||
== الخاصيات الإضافية (Extension Properties) == | == الخاصيات الإضافية (Extension Properties) == | ||
=== <code>[[Kotlin/ranges/downTo|downTo]]</code> === | === <code>[[Kotlin/ranges/downTo|downTo]]</code> === | ||
تعيد الدالة <code>downTo()</code> مجالا متدرّجًا (progression) تنازليًا من القيمة التي استُدعيت عبرها وحتى القيمة الممرّرة. ينبغي أن تكون القيمة الممررة أصغر من القيمة التي استُدعيت عبرها الدالة، وإلّا ستعيد الدالة مجالا متدرجا فارغًا. | |||
# | # | ||
# | # | ||
# | # | ||
=== <code>[[Kotlin/ranges/until|until]]</code> === | === <code>[[Kotlin/ranges/until|until]]</code> === | ||
تعيد الدالة <code>until()</code> مجالا (range) تصاعديًا من القيمة التي استُدعيت عبرها وحتى القيمة الممرّرة (القيمة المُمرّرة مُستثناة). | |||
# | # | ||
=== <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>[[Kotlin/collections/first|first]]</code> === | === <code>[[Kotlin/collections/first|first]]</code> === |
مراجعة 12:23، 14 يوليو 2018
الدوال
compareTo
تقارن الدالةcompareTo()
بين قيمة العنصر الذي استُدعيت عبره والقيمة المُمرّرة، إذ تعيد القيمة 0
إن كانا متساويين، أو تعيد قيمة سلبية إن كانت قيمة العنصر الذي استُدعيت عبره أصغر من القيمة المُمرّرة، أو تعيد قيمة موجبة إن كانت قيمة العنصر الذي استُدعيت عبره أكبر من القيمة المُمرّرة .
dec
تخفض الدالةdec()
قيمة العدد الذي استُدعيت عبره بواحد ثم تعيد القيمة الناتجة.
div
تقوم الدالةdiv()
بقسمة العدد الذي استُدعيت عبره على العدد الممرّر.
inc
ترفع الدالةinc()
قيمة العدد الذي استُدعيت عبره بواحد ثم تعيد القيمة الناتجة.
minus
تقوم الدالةminus()
بطرح العدد الممرّر من العدد الذي استُدعيت عبره.
plus
تقوم الدالةplus()
بإضافة العدد الممرّر إلى العدد الذي استُدعيت عبره.
rangeTo
تنشئ الدالةrangeTo()
مجالًا من العنصر الذي استُدعيت عبره إلى القيمة المُمرّرة.
rem
تحسب الدالةrem()
باقي عملية قسمة العدد الذي استُدعيت عبره على العدد الممرّر إليها.
times
تقوم الدالةtimes()
بحساب ضرب العدد الممرّر مع العدد الذي استُدعيت عبره.
toByte
تحوّل الدالةtoByte()
قيمة العنصر الذي استُدعيت عبره إلى عدد من النوع Byte
، والذي قد يعني أنه سيحسب بشكل تقريبي.
toChar
تعيد الدالةtoChar()
الحرف المقابل للقيمة العددية للعنصر الذي استُدعيت عبره، مُقتطعة (truncated) إلى 16 بتة إن كان ضروريًا.
toDouble
تحول الدالةtoDouble()
قيمة العنصر الذي استُدعيت عبره إلى عدد من النوع Double
، والذي قد يعني أنه سيحسب بشكل تقريبي.
toFloat
تحول الدالةtoFloat()
قيمة العنصر الذي استُدعيت عبره إلى عدد من النوع Float
، والذي قد يعني أنه سيحسب بشكل تقريبي.
toInt
تحول الدالةtoInt()
قيمة العنصر الذي استُدعيت عبره إلى عدد من النوع int
، والذي قد يعني أنه سيحسب بشكل تقريبي.
toLong
تحول الدالةtoLong()
قيمة العنصر الذي استُدعيت عبره إلى عدد من النوع Long
، والذي قد يعني أنه سيحسب بشكل تقريبي.
toShort
تحول الدالةtoShort()
قيمة العنصر الذي استُدعيت عبره إلى عدد من النوع Short
، والذي قد يعني أنه سيحسب بشكل تقريبي.
unaryMinus
تعيد الدالةunaryMinus()
سالب العدد الذي استُدعيت عبره.
unaryPlus
تعيد الدالةunaryPlus()
العدد الذي استُدعيت عبره.
الخاصيات المصاحبة (Companion Object Properties)
MAX_VALUE
MAX_VALUE
هي ثابتة تحتوي القيمة القصوى للنوع Byte
.
MIN_VALUE
MIN_VALUE
هي ثابتة تحتوي القيمة الدنيا للنوع Byte
.
الخاصيات الإضافية (Extension Properties)
downTo
تعيد الدالة downTo()
مجالا متدرّجًا (progression) تنازليًا من القيمة التي استُدعيت عبرها وحتى القيمة الممرّرة. ينبغي أن تكون القيمة الممررة أصغر من القيمة التي استُدعيت عبرها الدالة، وإلّا ستعيد الدالة مجالا متدرجا فارغًا.
until
تعيد الدالة until()
مجالا (range) تصاعديًا من القيمة التي استُدعيت عبرها وحتى القيمة الممرّرة (القيمة المُمرّرة مُستثناة).
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.