الفرق بين المراجعتين ل"Kotlin/Byte"

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث
ط (نقل جميل-بيلوني صفحة Kotlin/Byte/index إلى Kotlin/Byte: السبب هو وجود الكلمة "index" في نهاية الرابط وهذا يخالف ما هو معتمد في بقية صفحات الموسوعة.)
سطر 1: سطر 1:
 +
يمثل الصنف <code>Byte</code> عددًا صحيحًا ذا إشارة (signed integer) بحجم 8 بت. في بيئة التشغيل JVM، القيم غير المعدومة (non-nullable) لهذا النوع تُمثَّل كقيم للنوع <code>byte</code> الأساسي.<syntaxhighlight lang="kotlin">
 +
class Byte : Number, Comparable<Byte>
 +
</syntaxhighlight>
 +
 
== الدوال ==
 
== الدوال ==
  
 
=== [[Kotlin/Byte/compareTo|compareTo]] ===
 
=== [[Kotlin/Byte/compareTo|compareTo]] ===
−
تقارن الدالة<code>compareTo()‎</code> بين قيمة العنصر الذي استُدعيت عبره والقيمة المُمرّرة، إذ تعيد القيمة <code>0</code> إن كانا متساويين، أو تعيد قيمة سلبية إن كانت قيمة العنصر الذي استُدعيت عبره أصغر من القيمة المُمرّرة، أو تعيد قيمة موجبة إن كانت قيمة العنصر الذي استُدعيت عبره أكبر من القيمة المُمرّرة .<noinclude>{{DISPLAYTITLE:الصنف <code>‎‎Byte</code>‎ في Kotlin}}</noinclude>
+
توازن الدالة <code>compareTo()‎</code> بين قيمة العنصر الذي استُدعي معها والقيمة المُمرّرة إليها ثمَّ تعيد القيمة 0 إن كانا متساويين، أو قيمة سالبة إن كانت القيمة الأولى (قيمة العنصر الذي استُدعيت معه) أصغر من القيمة الثانية، أو قيمة موجبة إن كانت القيمة الأولى أكبر من القيمة الثانية.<noinclude>{{DISPLAYTITLE:الصنف <code>‎‎Byte</code>‎ في Kotlin}}</noinclude>
 
=== <code>[[Kotlin/Byte/dec|dec]]</code> ===
 
=== <code>[[Kotlin/Byte/dec|dec]]</code> ===
−
تخفض الدالة<code>dec()‎</code> قيمة العدد الذي استُدعيت عبره بواحد ثم تعيد القيمة الناتجة.
+
تنقص الدالة <code>dec()‎</code> القيمة التي استُدعيت معها بمقدار 1 ثم تعيد القيمة الناتجة.
  
 
=== <code>[[Kotlin/Byte/div|div]]</code> ===
 
=== <code>[[Kotlin/Byte/div|div]]</code> ===
−
تقوم الدالة<code>div()‎</code> بقسمة العدد الذي استُدعيت عبره على العدد الممرّر.
+
تقسِّم الدالة <code>div()‎</code> العدد الذي استُدعي معه على العدد الممرّر إليها ثم تعيد الناتج.
  
 
=== <code>[[Kotlin/Byte/inc|inc]]</code> ===
 
=== <code>[[Kotlin/Byte/inc|inc]]</code> ===
−
ترفع الدالة<code>inc()‎</code> قيمة العدد الذي استُدعيت عبره بواحد ثم تعيد القيمة الناتجة.
+
تزيد الدالة <code>inc()‎</code> القيمة التي استُدعيت معها بمقدار 1 ثم تعيد القيمة الناتجة.
  
 
=== <code>[[Kotlin/Byte/minus|minus]]</code> ===
 
=== <code>[[Kotlin/Byte/minus|minus]]</code> ===
−
تقوم الدالة<code>minus()‎</code> بطرح العدد الممرّر من العدد الذي استُدعيت عبره.
+
تطرح الدالة <code>minus()‎</code> العدد الممرّر إليها من العدد الذي استُدعي معها ثم تعيد الناتج.
  
 
=== <code>[[Kotlin/Byte/plus|plus]]</code> ===
 
=== <code>[[Kotlin/Byte/plus|plus]]</code> ===
−
تقوم الدالة<code>plus()‎</code> بإضافة العدد الممرّر إلى العدد الذي استُدعيت عبره.
+
تجمع الدالة <code>plus()‎</code> العدد الممرّر إليها مع العدد الذي استُدعي معها ثم تعيد الناتج.
  
 
=== <code>[[Kotlin/Byte/rangeTo|rangeTo]]</code> ===
 
=== <code>[[Kotlin/Byte/rangeTo|rangeTo]]</code> ===
−
تنشئ الدالة<code>rangeTo()‎</code> مجالًا من العنصر الذي استُدعيت عبره إلى القيمة المُمرّرة.
+
تنشئ الدالة <code>rangeTo()‎</code> مجالًا يقع بين القيمة التي استدعيت معها والقيمة المُمرّرة إليها.
  
 
=== <code>[[Kotlin/Byte/rem|rem]]</code> ===
 
=== <code>[[Kotlin/Byte/rem|rem]]</code> ===
−
تحسب الدالة<code>rem()‎</code> باقي عملية قسمة العدد الذي استُدعيت عبره على العدد الممرّر إليها.
+
تحسب الدالة <code>rem()‎</code> باقي عملية قسمة العدد الذي استُدعيت معه على العدد الممرّر إليها.
  
 
=== <code>[[Kotlin/Byte/times|times]]</code> ===
 
=== <code>[[Kotlin/Byte/times|times]]</code> ===
−
تقوم الدالة<code>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>toByte()‎</code> العدد الذي استُدعي معها إلى عدد من النوع <code>[[Kotlin/Byte|Byte]]</code>، وهذا قد يؤدي إلى تقريب العدد أو اقتطاع جزءٍ منه.
  
 
=== <code>[[Kotlin/Byte/toChar|toChar]]</code> ===
 
=== <code>[[Kotlin/Byte/toChar|toChar]]</code> ===
−
تعيد الدالة<code>toChar()‎</code> الحرف المقابل للقيمة العددية للعنصر الذي استُدعيت عبره، مُقتطعة (truncated) إلى 16 بتة إن كان ضروريًا.
+
تحول الدالة <code>toChar()‎</code> القيمة العددية للكائن الذي استُدعي معها إلى الحرف المقابل في جدول ASCII، ويمكن تقطيعه إلى 16 بت إن كان ذلك ضروريًا.
  
 
=== <code>[[Kotlin/Byte/toDouble|toDouble]]</code> ===
 
=== <code>[[Kotlin/Byte/toDouble|toDouble]]</code> ===
−
تحول الدالة<code>toDouble()‎</code> قيمة العنصر الذي استُدعيت عبره إلى عدد من النوع <code>[[Kotlin/Double/index|Double]]</code>، والذي قد يعني أنه سيحسب بشكل تقريبي.
+
تحول الدالة <code>toDouble()‎</code> العدد الذي استُدعي معها إلى عدد من النوع <code>[[Kotlin/Double|Double]]</code>، وهذا قد يؤدي إلى تقريب العدد.
  
 
=== <code>[[Kotlin/Byte/toFloat|toFloat]]</code> ===
 
=== <code>[[Kotlin/Byte/toFloat|toFloat]]</code> ===
−
تحول الدالة<code>toFloat()‎</code> قيمة العنصر الذي استُدعيت عبره إلى عدد من النوع <code>[[Kotlin/Float/index|Float]]</code>، والذي قد يعني أنه سيحسب بشكل تقريبي.
+
تحوِّل الدالة <code>toFloat()‎</code> العدد الذي استُدعي معها إلى عدد من النوع <code>[[Kotlin/Float|Float]]</code>، وهذا قد يؤدي إلى تقريب العدد.
  
 
=== <code>[[Kotlin/Byte/toInt|toInt]]</code> ===
 
=== <code>[[Kotlin/Byte/toInt|toInt]]</code> ===
−
تحول الدالة<code>toInt()‎</code> قيمة العنصر الذي استُدعيت عبره إلى عدد من النوع <code>int</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>toLong()‎</code> العدد الذي استُدعي معها إلى عدد من النوع <code>Long</code>، وهذا قد يؤدي إلى تقريب العدد أو اقتطاع جزءٍ منه.
  
 
=== <code>[[Kotlin/Byte/toShort|toShort]]</code> ===
 
=== <code>[[Kotlin/Byte/toShort|toShort]]</code> ===
−
تحول الدالة<code>toShort()‎</code> قيمة العنصر الذي استُدعيت عبره إلى عدد من النوع <code>Short</code>، والذي قد يعني أنه سيحسب بشكل تقريبي.
+
تحوِّل الدالة <code>toShort()‎</code> العدد الذي استُدعي معها إلى عدد من النوع <code>Short</code>، وهذا قد يؤدي إلى تقريب العدد أو اقتطاع جزءٍ منه.
  
 
=== <code>[[Kotlin/Byte/unaryMinus|unaryMinus]]</code> ===
 
=== <code>[[Kotlin/Byte/unaryMinus|unaryMinus]]</code> ===
−
تعيد الدالة<code>unaryMinus()‎</code> سالب العدد الذي استُدعيت عبره.
+
تعيد الدالة <code>unaryMinus()‎</code> القيمة السالبة المقابلة للقيمة التي استُدعيت معها.
  
 
=== <code>[[Kotlin/Byte/unaryPlus|unaryPlus]]</code> ===
 
=== <code>[[Kotlin/Byte/unaryPlus|unaryPlus]]</code> ===
−
تعيد الدالة<code>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>Byte.MAX_VALUE‎</code> أكبر قيمة يمكن تخزينها في النوع <code>[[Kotlin/Byte|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>.
+
يمثِّل الثابت <code>Byte.MIN_VALUE</code> أصغر قيمة يمكن تخزينها في النوع <code>[[Kotlin/Byte|Byte]]</code>.
  
 
== الدوال الإضافية (Extension Functions) ==
 
== الدوال الإضافية (Extension Functions) ==
  
−
=== <code>[[Kotlin/ranges/downTo|downTo]]</code> ===
+
=== <code>[[Kotlin/experimental/and|and]]</code> ===
−
تعيد الدالة ‎<code>downTo()‎</code> مجالا متدرّجًا (progression) تنازليًا من القيمة التي استُدعيت عبرها وحتى القيمة الممرّرة. ينبغي أن تكون القيمة الممررة أصغر من القيمة التي استُدعيت عبرها الدالة، وإلّا ستعيد الدالة مجالا متدرجا فارغًا.
 
−
#
 
−
#
 
−
#
 
−
=== <code>[[Kotlin/ranges/until|until]]</code> ===
 
−
تعيد الدالة ‎<code>until()‎</code> مجالا (range) تصاعديًا من القيمة التي استُدعيت عبرها وحتى القيمة الممرّرة (القيمة المُمرّرة مُستثناة).
 
−
#
 
−
=== <code>[[Kotlin/collections/distinct|distinct]]</code> ===
 
−
تحذف الدالة <code>distinct()‎</code> العناصر المتكررة الموجودة في <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت معها وتعيد الناتج في قائمة. تُرتَّب العناصر في القائمة الناتجة بنفس ترتيبها في المصفوفة أو المجموعة الأصليَّة.
 
  
−
=== <code>[[Kotlin/collections/distinctBy|distinctBy]]</code> ===
+
=== <code>[[Kotlin/ranges/coerceAtLeast|coerceAtLeast]]</code> ===
−
تعيد الدالة <code>distinctBy()‎</code> قائمة تحتوي على العناصر الموجودة في <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/Array|المجموعة]] التي استُدعيت معها والتي تعطي نتيجة مختلفة عند تطبيق الدالة <code>selector</code> عليها فقط. تُرتَّب العناصر في القائمة الناتجة بنفس ترتيبها في المصفوفة أو المجموعة الأصليَّة.
 
  
−
=== <code>[[Kotlin/collections/drop|drop]]</code> ===
+
=== <code>[[Kotlin/ranges/coerceAtMost|coerceAtMost]]</code> ===
−
تعيد الدالة <code>drop()‎</code> قائمة تحوي جميع عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/Array|المجموعة]] التي استُدعيت معها باستثناء أول <code>n</code> عنصر.
 
  
−
=== <code>[[Kotlin/collections/dropLast|dropLast]]</code> ===
+
=== <code>[[Kotlin/ranges/coerceIn|coerceIn]]</code> ===
−
تعيد الدالة <code>dropLast()‎</code> قائمة تحوي جميع عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/Array|المجموعة]] التي استُدعيت معها باستثناء آخر <code>n</code> عنصر.
 
  
−
=== <code>[[Kotlin/collections/dropLastWhile|dropLastWhile]]</code> ===
+
=== <code>[[Kotlin/ranges/downTo|downTo]]</code> ===
−
تعيد الدالة <code>dropLastWhile()‎</code> قائمةً تحوي جميع عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت معها باستثناء العناصر الأخيرة التي تحقق شرطًا معيَّنًا.
+
تنشئ الدالة ‎<code>downTo()‎</code> مجالًا متدرجًا (progression) يبدًأ من القيمة القصوى التي استُدعيت معها وينحدر تنازليًّا حتى يصل إلى القيمة الممرّرة إليها.
−
 
 
−
=== <code>[[Kotlin/collections/dropWhile|dropWhile]]</code> ===
 
−
تعيد الدالة <code>dropLastWhile()‎</code> قائمةً تحوي جميع عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت معها باستثناء العناصر الأولى التي تحقق شرطًا معيَّنًا.
 
−
 
 
−
=== <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>elementAtOrElse()‎</code> عنصرًا ذي فهرس معيَّن من <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت معها. إن كان الفهرس المعطى خارج حدود<nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/Array|المجموعة]]، فستُعيد الدالة ناتج استدعاء دالة معينة.
 
−
 
 
−
=== <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>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>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>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>first()‎</code> العنصر الأول من <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت عبرها، وفي حال تمرير دالة منطقية كمعامل فستعيد أول عنصر يحقق تلك الدالة.
 
−
 
 
−
=== <code>[[Kotlin/collections/firstOrNull|firstOrNull]]</code> ===
 
−
تعيد الدالة<code>firstOrNull()‎</code> العنصر الأول من <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت عبرها، وفي حال تمرير دالة منطقية كمعامل فستعيد أول عنصر يحقق تلك الدالة.
 
−
 
 
−
=== <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>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>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>foldIndexed()‎</code> القيم بدءًا من القيمة المُمرّرة <code>initial</code> وتطبّق العملية <code>operation</code> من اليسار إلى اليمين على القيمة المُتراكمة الراهنة وعلى العنصر التالي من <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت عبرها وكذلك فهرسه. وتُعيد القيمة النهائية.
 
−
 
 
−
=== <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>foldRightIndexed()‎</code> القيم بدءًا من القيمة المُمرّرة <code>initial</code> وتطبّق العملية <code>operation</code> من اليمين إلى اليسار على القيمة المُتراكمة الراهنة وعلى العنصر التالي من <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت عبرها وكذلك فهرسه. وتُعيد القيمة النهائية.
 
−
 
 
−
=== <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>forEachIndexed()‎</code> الدالةَ المُمرّرةَ <code>action</code> على كل عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] أو القاموس الذي استُدعيت عبره وعلى فهارسها (indices).
 
−
 
 
−
=== <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>getOrNull()‎</code> قيمة العنصر عند الفهرس <code>index</code> المُحدَّد في <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت عبرها. ، أو <code>null</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>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>indexOf()‎</code> فهرس أول ظهور للعنصر المُمرّر إليها في <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] أو اللائحة التي استُدعيت عبرها ، أو ‎<code>-1‎</code> إن كان العنصر المُمرّر غير موجود.
 
−
 
 
−
=== <code>[[Kotlin/collections/indexOfFirst|indexOfFirst]]</code> ===
 
−
تعيد الدالة <code>indexOfFirst()‎</code> فهرس أول ظهور للعنصر المُمرّر إليها في <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] أو اللائحة التي استُدعيت عبرها والذي يحقق الشرط المنطقي المُمرّر <code>predicate</code>، أو ‎<code>-1‎</code> إن لم يكن هناك أي عنصر يحقق ذلك.
 
  
−
=== <code>[[Kotlin/collections/indexOfLast|indexOfLast]]</code> ===
+
=== <code>[[Kotlin/experimental/inv|inv]]</code> ===
−
تعيد الدالة <code>indexOfLast()‎</code> فهرس آخر ظهور للعنصر المُمرّر إليها في <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] أو اللائحة التي استُدعيت عبرها والذي يحقق الشرط المنطقي المُمرّر <code>predicate</code>، أو ‎<code>-1‎</code> إن لم يكن هناك أي عنصر يحقق ذلك.
 
  
−
=== <code>[[Kotlin/collections/intersect|intersect]]</code> ===
+
=== <code>[[Kotlin/experimental/or|or]]</code> ===
−
تعيد الدالة <code>intersect()‎</code>مجموعة تحتوي كل العناصر المشتركة بين <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت عبرها وتلك الممرّرة إلى الدالة.
 
  
−
=== <code>[[Kotlin/collections/isEmpty|isEmpty]]</code> ===
+
=== <code>[[Kotlin/kotlin.text/toString|toString]]</code> ===
−
تعيد الدالة <code>isEmpty()‎</code> القيمة <code>true</code> إن كانت <nowiki/>[[Kotlin/Array|المصفوفة]] التي استُدعيت عبرها فارغةً.
+
تحول الدالة <code>toString()</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>joinTo()‎</code> سلسة نصية من عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت عبرها مفصولة بالمعامل المُمرّر <code>separator</code> وباستخدام البادئة<code>prefix</code> واللاحقة <code>postfix</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>last()‎</code> العنصر الأخير من <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] أو اللائحة التي استُدعيت عبرها. في حال تمرير شرط منطقي <code>predicate</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>lastOrNull()‎</code> العنصر الأخير من <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] أو اللائحة التي استُدعيت عبرها. في حال تمرير شرط منطقي <code>predicate</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>mapIndexed()‎</code> لائحة تضم ناتج تطبيق الدالة <code>transform()‎</code> المُمرّرة إليها على عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت عبرها وعلى فهارسها.
 
−
 
 
−
=== <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>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>maxBy()‎</code> العنصر الأول في <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت عبره والذي له أكبر قيمة معادة من الدالة الممررة <code>selector</code>، أو <code>null</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>minBy()‎</code> العنصر الأول في <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت عبره والذي له أصغر قيمة معادة من الدالة الممررة <code>selector</code>، أو <code>null</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>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>partition()‎</code> <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت عبرها إلى زوج مكوّن من لائحتين، اللائحة الأولى تضم العناصر التي تحقق الشرط المنطقي المُمرّر <code>predicate</code> (أي تعيد <code>true</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>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>reduceIndexed()‎</code> القيم بدءًا من العنصر الأول في <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت عبرها وتطبّق العملية <code>operation</code> من اليسار إلى اليمين على القيمة المُتراكمة الراهنة وعلى العنصر الموالي في <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت عبرها وعلى فهرسه. ثم تُعيد القيمة النهائية.
 
−
 
 
−
=== <code>[[Kotlin/collections/reduceRight|reduceRight]]</code> ===
 
−
تُراكِم الدالة<code>reduceRight()‎</code> القيم بدءًا من العنصر الأخير وتطبّق العملية <code>operation</code> من اليمين إلى اليسار على العنصر الموالي في <nowiki/>[[Kotlin/Array|المصفوفة]] أواللائحة التي استُدعيت عبرها وعلى القيمة المُتراكمة الراهنة. ثم تُعيد القيمة النهائية.
 
−
 
 
−
=== <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>reverse()‎</code> ترتيب عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو اللائحة التي استُدعيت عبرها.
 
−
 
 
−
=== <code>[[Kotlin/collections/reversed|reversed]]</code> ===
 
−
تُعيد الدالة<code>reversed()‎</code> لائحة تضم عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت عبرها بالترتيب المعكوس.
 
−
 
 
−
=== <code>[[Kotlin/collections/reversedArray|reversedArray]]</code> ===
 
−
تُعيد الدالة<code>reversedArray()‎</code> <nowiki/>[[Kotlin/Array|مصفوفة]] تضم عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] التي استُدعيت عبرها بالترتيب المعكوس.
 
−
 
 
−
=== <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>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>slice()‎</code>لائحة تحتوي عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو اللائحة التي استُدعيت عبرها والموجودة عند الفهارس التي يحددها الوسيط الممرّر <code>indices</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>sortedBy()‎</code> لائحة تضم عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو اللائحة المتغيرة (<code>MutableList</code>) التي استُدعيت عبرها مرتبة وفقًا للقيم التي تعيدها الدالة المُمرّرة <code>selector</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>sortedWith()‎</code> لائحة تضم عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو المجموعة التكرارية التي استُدعيت عبرها مرتبة وفق المُقارِن المُمرّر <code>comparator</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>sumBy()‎</code> مجموع العناصر المُعادة من الدالة <code>selector</code> مطبقةً على عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت عبرها.
 
−
 
 
−
=== <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>take()‎</code> لائحة تضم <code>n</code> من أولى العناصر الموجودة في <nowiki/>[[Kotlin/Array|المصفوفة]] أو المجموعة التكرارية التي استُدعيت عبرها.
 
−
 
 
−
=== <code>[[Kotlin/collections/takeLast|takeLast]]</code> ===
 
−
تعيد الدالة<code>takeLast()‎</code> لائحة تضم آخر <code>n</code> من العناصر الموجودة في <nowiki/>[[Kotlin/Array|المصفوفة]] أو المجموعة التكرارية التي استُدعيت عبرها.
 
−
 
 
−
=== <code>[[Kotlin/collections/takeLastWhile|takeLastWhile]]</code> ===
 
−
تعيد الدالة<code>takeLastWhile()‎</code> لائحة تضم آخر عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو اللائحة التي استُدعيت عبرها والتي تحقق الشرط المنطقي المُمرّر <code>predicate</code>.
 
−
 
 
−
=== <code>[[Kotlin/collections/takeWhile|takeWhile]]</code> ===
 
−
تعيد الدالة<code>takeWhile()‎</code> لائحة تضم أولى عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو المجموعة التكرارية التي استُدعيت عبرها والتي تحقق الشرط المنطقي المُمرّر<code>predicate</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>toHashSet()‎</code> كائنًا من النوع <code>HashSet</code>يضم جميع عناصر <nowiki/>[[Kotlin/Array|المصفوفة]]  أو <nowiki/>[[Kotlin/collections|المجموعة]]  التي استُدعيت عبرها.
 
−
 
 
−
=== <code>[[Kotlin/collections/toList|toList]]</code> ===
 
−
تعيد الدالة<code>toList()‎</code> لائحة تضم جميع عناصر <nowiki/>[[Kotlin/Array|المصفوفة]]  أو المجموعة التكرارية  التي استُدعيت عبرها. وفي حال استدعاء الدالة<code>toList()‎</code> عبر قاموسفستعيد لائحة تضم جميع الأزواج مفتاح/قيمة المنتمية إليه.
 
−
 
 
−
=== <code>[[Kotlin/collections/toMutableList|toMutableList]]</code> ===
 
−
تعيد الدالة<code>toMutableList()‎</code> لائحة متغيرة تضم جميع عناصر <nowiki/>[[Kotlin/Array|المصفوف]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت عبرها.
 
−
 
 
−
=== <code>[[Kotlin/collections/toMutableSet|toMutableSet]]</code> ===
 
−
تعيد الدالة<code>toMutableSet()‎</code> مجموعة من النوع <code>MutableSet</code> تضم جميع عناصر <nowiki/>[[Kotlin/Array|المصفوفة]]  أو المجموعة التكرارية  التي استُدعيت عبرها بدون تكرار.
 
−
 
 
−
=== <code>[[Kotlin/collections/toSet|toSet]]</code> ===
 
−
تعيد الدالة<code>toSet()‎</code>  مجموعة من النوع <code>Set</code> تضم جميع عناصر <nowiki/>[[Kotlin/Array|المصفوفة]]  أو المجموعة التكرارية  التي استُدعيت عبرها.
 
−
 
 
−
=== <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>union()‎</code> مجموعة من النوع Set تضم جميع عناصر <nowiki/>[[Kotlin/Array|المصفوفة]]  أو المجموعة التكرارية  التي استُدعيت عبرها والمجموعة التكرارية المُمرّرة.
 
−
 
 
−
=== <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>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|البنية العامة]] لأجل التفاصيل.
 
 
#
 
#
 
#
 
#
 
#
 
#
 +
=== <code>[[Kotlin/ranges/until|until]]</code> ===
 +
تنشئ الدالة ‎<code>until()‎</code> مجالًا (range) تصاعديًا يبدأ القيمة التي استُدعيت معها وحتى القيمة الممرّرة إليها (لا تدخل هذه القيمة ضمن المجال).
 +
 +
=== <code>[[Kotlin/experimental/xor|xor]]</code> ===
 
#
 
#
 
#
 
#
سطر 348: سطر 111:
 
#
 
#
  
 +
== مصادر ==
 +
* [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-byte/index.html صفحة الصنف Byte في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 
[[تصنيف:Kotlin]]
 
[[تصنيف:Kotlin]]
−
[[تصنيف:Kotlin Classes]]
+
[[تصنيف:Kotlin Class]]
 
[[تصنيف:Kotlin Byte]]
 
[[تصنيف:Kotlin Byte]]

مراجعة 14:54، 8 سبتمبر 2018

يمثل الصنف Byte عددًا صحيحًا ذا إشارة (signed integer) بحجم 8 بت. في بيئة التشغيل JVM، القيم غير المعدومة (non-nullable) لهذا النوع تُمثَّل كقيم للنوع byte الأساسي.

class Byte : Number, Comparable<Byte>

الدوال

compareTo

توازن الدالة compareTo()‎ بين قيمة العنصر الذي استُدعي معها والقيمة المُمرّرة إليها ثمَّ تعيد القيمة 0 إن كانا متساويين، أو قيمة سالبة إن كانت القيمة الأولى (قيمة العنصر الذي استُدعيت معه) أصغر من القيمة الثانية، أو قيمة موجبة إن كانت القيمة الأولى أكبر من القيمة الثانية.

dec

تنقص الدالة dec()‎ القيمة التي استُدعيت معها بمقدار 1 ثم تعيد القيمة الناتجة.

div

تقسِّم الدالة div()‎ العدد الذي استُدعي معه على العدد الممرّر إليها ثم تعيد الناتج.

inc

تزيد الدالة inc()‎ القيمة التي استُدعيت معها بمقدار 1 ثم تعيد القيمة الناتجة.

minus

تطرح الدالة minus()‎ العدد الممرّر إليها من العدد الذي استُدعي معها ثم تعيد الناتج.

plus

تجمع الدالة plus()‎ العدد الممرّر إليها مع العدد الذي استُدعي معها ثم تعيد الناتج.

rangeTo

تنشئ الدالة rangeTo()‎ مجالًا يقع بين القيمة التي استدعيت معها والقيمة المُمرّرة إليها.

rem

تحسب الدالة rem()‎ باقي عملية قسمة العدد الذي استُدعيت معه على العدد الممرّر إليها.

times

تضرب الدالة times()‎ العدد الممرّر إليها بالعدد المستدعى معها ثم تعيد الناتج.

toByte

تحوّل الدالة toByte()‎ العدد الذي استُدعي معها إلى عدد من النوع Byte، وهذا قد يؤدي إلى تقريب العدد أو اقتطاع جزءٍ منه.

toChar

تحول الدالة toChar()‎ القيمة العددية للكائن الذي استُدعي معها إلى الحرف المقابل في جدول ASCII، ويمكن تقطيعه إلى 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

يمثِّل الثابت Byte.MAX_VALUE‎ أكبر قيمة يمكن تخزينها في النوع Byte.

MIN_VALUE

يمثِّل الثابت Byte.MIN_VALUE أصغر قيمة يمكن تخزينها في النوع Byte.

الدوال الإضافية (Extension Functions)

and

coerceAtLeast

coerceAtMost

coerceIn

downTo

تنشئ الدالة ‎downTo()‎ مجالًا متدرجًا (progression) يبدًأ من القيمة القصوى التي استُدعيت معها وينحدر تنازليًّا حتى يصل إلى القيمة الممرّرة إليها.

inv

or

toString

تحول الدالة toString()‎ العدد الذي استٌدعي معها وفقًا لأساس مُحدّد إلى سلسلة نصية.

until

تنشئ الدالة ‎until()‎ مجالًا (range) تصاعديًا يبدأ القيمة التي استُدعيت معها وحتى القيمة الممرّرة إليها (لا تدخل هذه القيمة ضمن المجال).

xor

مصادر

مجلوبة من "https://wiki.hsoub.com/index.php?title=Kotlin/Byte&oldid=17255"