الصنف ‎‎Byte‎ في Kotlin

الدوال

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.