الفرق بين المراجعتين لصفحة: «Kotlin/Byte»

من موسوعة حسوب
→ التعديل السابق
مرئينص الويكي
لا ملخص تعديل
طلا ملخص تعديل
 
(4 مراجعات متوسطة بواسطة مستخدمين اثنين آخرين غير معروضة)
سطر 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 Properties) ==
== الدوال الإضافية (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>[[Kotlin/experimental/inv|inv]]</code> ===
تعيد الدالة <code>dropLastWhile()‎</code> قائمةً تحوي جميع عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت معها باستثناء العناصر الأولى التي تحقق شرطًا معيَّنًا.


=== <code>[[Kotlin/collections/elementAt|elementAt]]</code> ===
=== <code>[[Kotlin/experimental/or|or]]</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/kotlin.text/toString|toString]]</code> ===
تجلب الدالة <code>elementAtOrElse()‎</code> عنصرًا ذي فهرس معيَّن من <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت معها. إن كان الفهرس المعطى خارج حدود<nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/Array|المجموعة]]، فستُعيد الدالة ناتج استدعاء دالة معينة.
تحول الدالة <code>toString()</code>‎ العدد الذي استٌدعي معها وفقًا لأساس مُحدّد إلى سلسلة نصية.


=== <code>[[Kotlin/collections/elementAtOrNull|elementAtOrNull]]</code> ===
=== <code>[[Kotlin/ranges/until|until]]</code> ===
تجلب الدالة <code>elementAtOrNull()‎</code> عنصرًا ذي فهرس معيَّن من <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت معها. إن كان الفهرس المعطى خارج حدود<nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/Array|المجموعة]]، فستُعيد الدالة القيمة العدمية <code>null</code>.
تنشئ الدالة ‎<code>until()‎</code> مجالًا (range) تصاعديًا يبدأ القيمة التي استُدعيت معها وحتى القيمة الممرّرة إليها (لا تدخل هذه القيمة ضمن المجال).
 
=== <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>indexOfLast()‎</code> فهرس آخر ظهور للعنصر المُمرّر إليها في <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] أو اللائحة التي استُدعيت عبرها والذي يحقق الشرط المنطقي المُمرّر <code>predicate</code>، أو ‎<code>-1‎</code> إن لم يكن هناك أي عنصر يحقق ذلك.
 
=== <code>[[Kotlin/collections/intersect|intersect]]</code> ===
تعيد الدالة <code>intersect()‎</code>مجموعة تحتوي كل العناصر المشتركة بين <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت عبرها وتلك الممرّرة إلى الدالة.
 
=== <code>[[Kotlin/collections/isEmpty|isEmpty]]</code> ===
تعيد الدالة <code>isEmpty()‎</code> القيمة <code>true</code> إن كانت <nowiki/>[[Kotlin/Array|المصفوفة]] التي استُدعيت عبرها فارغةً.
 
=== <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>[[Kotlin/experimental/xor|xor]]</code> ===
=== <code>[[Kotlin/collections/sliceArray|sliceArray]]</code> ===
=== <code>[[Kotlin/collections/sortedBy|sortedBy]]</code> ===
=== <code>[[Kotlin/collections/sortedByDescending|sortedByDescending]]</code> ===
=== <code>[[Kotlin/collections/sortedWith|sortedWith]]</code> ===
=== <code>[[Kotlin/collections/subtract|subtract]]</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> ===
#
=== <code>[[Kotlin/collections/union|union]]</code> ===
=== <code>[[Kotlin/collections/withIndex|withIndex]]</code> ===
=== <code>[[Kotlin/collections/zip|zip]]</code> ===
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#


== مصادر ==
* [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-byte/index.html صفحة الصنف Byte في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin Classes]]
[[تصنيف:Kotlin Class]]
[[تصنيف:Kotlin Byte]]
[[تصنيف:Kotlin Byte]]

المراجعة الحالية بتاريخ 03:33، 9 سبتمبر 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=17338»