الصنف ‎‎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.

findLast

تعيد الدالةfindLast()‎ العنصر الأخير من المصفوفة أو المجموعة التي استُدعيت عبرها والذي يحقق الشرط المنطقي predicate المُمرّر إليها. وإن لم يكن هناك أي عنصر يحقق ذلك فستعيد null.

first

تعيد الدالةfirst()‎ العنصر الأول من المصفوفة أو المجموعة التي استُدعيت عبرها، وفي حال تمرير دالة منطقية كمعامل فستعيد أول عنصر يحقق تلك الدالة.

firstOrNull

تعيد الدالةfirstOrNull()‎ العنصر الأول من المصفوفة أو المجموعة التي استُدعيت عبرها، وفي حال تمرير دالة منطقية كمعامل فستعيد أول عنصر يحقق تلك الدالة.

flatMap

تعيد الدالةflatMap()‎ لائحة تضم ناتج تطبيق الدالة transform()‎ المُمرّرة إليها على عناصر المصفوفة أو المجموعة التي استُدعيت عبرها، وفي حال استدعاء الدالة flatMap()‎ على قاموس فستعيد لائحة تضم ناتج تطبيق الدالة transform()‎ على مداخل (entries) القاموس.

flatMapTo

تضيف الدالةflatMapTo()‎ إلى اللائحة المُتغيرة‎ (MutableCollection‎) ‎destinationالمُمرّرة إليها ناتج تطبيق الدالة transform()‎ على عناصر المصفوفة أو المجموعة التي استُدعيت عبرها، وفي حال استدعاء الدالة flatMapTo()‎ على قاموس فستضيف إلى اللائحة destination ناتج تطبيق الدالة transform()‎ على مداخل (entries) القاموس.

fold

يختلف سلوك الدالةfold()‎ حسب نوع الكائنات التي استُدعيت عبرها و نوع المعاملات (parameters) المُمرّرة إليها (انظر فقرة البنية العامة).

foldIndexed

تُراكِم الدالةfoldIndexed()‎ القيم بدءًا من القيمة المُمرّرة initial وتطبّق العملية operation من اليسار إلى اليمين على القيمة المُتراكمة الراهنة وعلى العنصر التالي من المصفوفة أو المجموعة التي استُدعيت عبرها وكذلك فهرسه. وتُعيد القيمة النهائية.

foldRight

تُراكِم الدالةfoldRight()‎ القيم بدءًا من القيمة المُمرّرة initial وتطبّق العملية operation من اليمين إلى اليسار على القيمة المُتراكمة الراهنة وعلى العنصر التالي من المصفوفة أو المجموعة التي استُدعيت عبرها. وتُعيد القيمة النهائية.

foldRightIndexed

تُراكِم الدالةfoldRightIndexed()‎ القيم بدءًا من القيمة المُمرّرة initial وتطبّق العملية operation من اليمين إلى اليسار على القيمة المُتراكمة الراهنة وعلى العنصر التالي من المصفوفة أو المجموعة التي استُدعيت عبرها وكذلك فهرسه. وتُعيد القيمة النهائية.

forEach

تُنفّد الدالةُforEach()‎ الدالةَ المُمرّرةَ action على كل عناصر المصفوفة أو المجموعة أو القاموس الذي استُدعيت عبره.

forEachIndexed

تُنفّد الدالةُforEachIndexed()‎ الدالةَ المُمرّرةَ action على كل عناصر المصفوفة أو المجموعة أو القاموس الذي استُدعيت عبره وعلى فهارسها (indices).

getOrElse

تعيد الدالة getOrElse()‎ قيمة العنصر عند الفهرس index المُحدَّد في المصفوفة أو المجموعة التي استُدعيت عبرها. ، أو نتيجة استدعاء الدالة المُمرّرة  defaultValue إن كان الفهرس خارج الحدود.

getOrNull

تعيد الدالة getOrNull()‎ قيمة العنصر عند الفهرس index المُحدَّد في المصفوفة أو المجموعة التي استُدعيت عبرها. ، أو null إن كان الفهرس خارج الحدود.

groupBy

تعيد الدالةgroupBy()‎ قاموسًا يُجمّع عناصر المصفوفة أو المجموعة التي استُدعيت عبرها حيث مفاتيحه تعيدها الدالة المُمرّرة keySelector وقيمه لوائحُ تضم عناصر المصفوفة أو المجموعة (أو ناتج تمرير عناصر المصفوفة أو المجموعة على الدالة valueTransform في حال تمريرها).

groupByTo

تجمّع الدالةgroupByTo()‎ عناصر المصفوفة أو المجموعة التي استُدعيت عبرها وتضيفها إلى القاموس.المُمرّر destination حيث مفاتيحه تعيدها الدالة الممرّرة keySelector()‎ مُطبّقة على كل عناصر المصفوفة أو المجموعة، وقيمُه لوائح تضم العناصر المقابلة، وفي حال تمرير معامل ثالثvalueTransform فإنّ القيم ستكون لوائح تضم ناتج تطبيق الدالة valueTransform على العناصر المقابلة . ثم تعيد القاموسdestination.

indexOf

تعيد الدالة indexOf()‎ فهرس أول ظهور للعنصر المُمرّر إليها في المصفوفة أو المجموعة أو اللائحة التي استُدعيت عبرها ، أو ‎-1‎ إن كان العنصر المُمرّر غير موجود.

indexOfFirst

تعيد الدالة indexOfFirst()‎ فهرس أول ظهور للعنصر المُمرّر إليها في المصفوفة أو المجموعة أو اللائحة التي استُدعيت عبرها والذي يحقق الشرط المنطقي المُمرّر predicate، أو ‎-1‎ إن لم يكن هناك أي عنصر يحقق ذلك.

indexOfLast

تعيد الدالة indexOfLast()‎ فهرس آخر ظهور للعنصر المُمرّر إليها في المصفوفة أو المجموعة أو اللائحة التي استُدعيت عبرها والذي يحقق الشرط المنطقي المُمرّر predicate، أو ‎-1‎ إن لم يكن هناك أي عنصر يحقق ذلك.

intersect

تعيد الدالة intersect()‎مجموعة تحتوي كل العناصر المشتركة بين المصفوفة أو المجموعة التي استُدعيت عبرها وتلك الممرّرة إلى الدالة.

isEmpty

تعيد الدالة isEmpty()‎ القيمة true إن كانت المصفوفة التي استُدعيت عبرها فارغةً.

isNotEmpty

تعيد الدالة isNotEmpty()‎ القيمة true إن كانت المصفوفة أو المجموعة التي استُدعيت عبرها غير فارغةً.

joinTo

تجمّع الدالةjoinTo()‎ سلسة نصية من عناصر المصفوفة أو المجموعة التي استُدعيت عبرها مفصولة بالمعامل المُمرّر separator وباستخدام البادئةprefix واللاحقة postfix في حال تمريرهما،

joinToString

تنشئ الدالةjoinToString()‎ سلسة نصية من عناصر المصفوفة أو المجموعة التي استُدعيت عبرها مفصولة بالمعامل المُمرّر separator وباستخدام البادئة prefix واللاحقة postfix في حال تمريرهما،

last

تعيد الدالةlast()‎ العنصر الأخير من المصفوفة أو المجموعة أو اللائحة التي استُدعيت عبرها. في حال تمرير شرط منطقي predicate كوسيط فستعيد العنصر الأخير الذي يحقق ذلك الشرط.

lastIndexOf

تعيد الدالةlastIndexOf()‎ آخر فهرس للعنصر الممرّر إلى المصفوفة أو المجموعة أو اللائحة التي استُدعيت عبرها. وإن لم يكن العنصر موجودًا فستعيد ‎-1‎.

lastOrNull

تعيد الدالةlastOrNull()‎ العنصر الأخير من المصفوفة أو المجموعة أو اللائحة التي استُدعيت عبرها. في حال تمرير شرط منطقي predicate كوسيط فستعيد العنصر الأخير الذي يحقق ذلك الشرط.

map

تعيد الدالةmap()‎ لائحة تضم ناتج تطبيق الدالة transform()‎ المُمرّرة إليها على عناصر المصفوفة أو المجموعة التي استُدعيت عبرها، وفي حال استدعاء الدالة map()‎ على قاموس فستعيد لائحة تضم ناتج تطبيق الدالة transform()‎ على مداخل (entries) القاموس.

mapIndexed

تعيد الدالةmapIndexed()‎ لائحة تضم ناتج تطبيق الدالة transform()‎ المُمرّرة إليها على عناصر المصفوفة أو المجموعة التي استُدعيت عبرها وعلى فهارسها.

mapIndexedTo

تطبق الدالةmapIndexedTo()‎ الدالة المُمررّة transform()‎ على عناصر المصفوفة أو المجموعة التي استُدعيت عبرها وعلى فهارسها وتضيف النتائج إلى المعامل الممرّر destination.

mapTo

تطبق الدالةmapTo()‎ الدالة المُمررّة transform()‎ على عناصر المصفوفة أو المجموعة التي استُدعيت عبرها وتضيف النتائج إلى المعامل الممرّرdestination.  وفي حال استدعاء الدالة mapTo()‎ على قاموس فستضيف نتائج تطبيق الدالةtransform()‎ على مداخل (entries) القاموس إلى المعامل الممرّر destination.

maxBy

تعيد الدالةmaxBy()‎ العنصر الأول في المصفوفة أو المجموعة التي استُدعيت عبره والذي له أكبر قيمة معادة من الدالة الممررة selector، أو null إن لم يكن هناك أي عنصر يحقق ذلك.

maxWith

تعيد الدالةmaxWith()‎ العنصر الأول في المصفوفة أو المجموعة التي استُدعيت عبره والذي له أكبر قيمة بحسب المقارِن comparator الممرّر، أو nullإن لم يكن هناك أي عنصر يحقق ذلك.

minBy

تعيد الدالةminBy()‎ العنصر الأول في المصفوفة أو المجموعة التي استُدعيت عبره والذي له أصغر قيمة معادة من الدالة الممررة selector، أو null إن لم يكن هناك أي عنصر يحقق ذلك.

minWith

تعيد الدالةminWith()‎ العنصر الأول في المصفوفة أو المجموعة التي استُدعيت عبرها والذي له أصغر قيمة بحسب المقارِن comparator الممرّر، أوnull إن لم يكن هناك أي عنصر يحقق ذلك.

none

تعيد الدالةnone()‎ القيمة true إن كانت المصفوفة أو المجموعة التي استُدعيت عبرها فارغة، أو تعيد false. وفي حال تمرير شرط منطقيpredicate. فستعيد true إن لم يكن هناك أي عنصر يحقق ذلك الشرط المنطقي، أو تعيد false.

partition

تُقسّم الدالةُpartition()‎ المصفوفة أو المجموعة التي استُدعيت عبرها إلى زوج مكوّن من لائحتين، اللائحة الأولى تضم العناصر التي تحقق الشرط المنطقي المُمرّر predicate (أي تعيد true)، بينما تضم الثانية العناصر الأخرى.

plus

يختلف سلوك الدالة plus()‎ حسب نوع الكائنات التي استُدعيت عبرها ونوع الوسائط الممررة (انظر فقرة البنية العامة).

reduce

يختلف سلوك الدالةreduce()‎ حسب نوع الكائنات التي استُدعيت عبرها ونوع المعاملات (parameters) المُمرّرة إليها (انظر فقرة البنية العامة).

reduceIndexed

تُراكِم الدالةreduceIndexed()‎ القيم بدءًا من العنصر الأول في المصفوفة أو المجموعة التي استُدعيت عبرها وتطبّق العملية operation من اليسار إلى اليمين على القيمة المُتراكمة الراهنة وعلى العنصر الموالي في المصفوفة أو المجموعة التي استُدعيت عبرها وعلى فهرسه. ثم تُعيد القيمة النهائية.

reduceRight

تُراكِم الدالةreduceRight()‎ القيم بدءًا من العنصر الأخير وتطبّق العملية operation من اليمين إلى اليسار على العنصر الموالي في المصفوفة أواللائحة التي استُدعيت عبرها وعلى القيمة المُتراكمة الراهنة. ثم تُعيد القيمة النهائية.

reduceRightIndexed

تُراكِم الدالةreduceRightIndexed()‎ القيم بدءًا من العنصر الأخير في المصفوفة أو اللائحة التي استُدعيت عبرها وتطبّق العملية operation من اليمين إلى اليسار على القيمة المُتراكمة الراهنة وعلى العنصر الموالي في المصفوفة أو المجموعة التي استُدعيت عبرها وعلى فهرسه. ثم تُعيد القيمة النهائية.

reverse

تعكس الدالةreverse()‎ ترتيب عناصر المصفوفة أو اللائحة التي استُدعيت عبرها.

reversed

تُعيد الدالةreversed()‎ لائحة تضم عناصر المصفوفة أو المجموعة التي استُدعيت عبرها بالترتيب المعكوس.

reversedArray

تُعيد الدالةreversedArray()‎ مصفوفة تضم عناصر المصفوفة التي استُدعيت عبرها بالترتيب المعكوس.

single

تعيد الدالةsingle()‎العنصر الوحيد الموجود في المصفوفة أو المجموعة أو اللائحة التي استُدعيت عبرها، وفي حال تمرير شرط منطقي predicateكمعامل (parameter) فستعيد العنصر الوحيد الذي يحقق ذلك الشرط المنطقي. أمّا في حال كان الكائن الذي استُدعيت عبره يحتوي أكثر من عنصر واحد (يحقق predicate في حال تمريرها) أو لا يحتوي أي واحد (يحقق predicate في حال تمريرها) فستطلق الدالة  single()‎استثناءً.

singleOrNull

تعيد الدالةsingleOrNull()‎العنصر الوحيد الموجود في المصفوفة أو المجموعة أو اللائحة التي استُدعيت عبرها، وفي حال تمرير شرط منطقيpredicate كمعامل (parameter) فستعيد العنصر الوحيد الذي يحقق ذلك الشرط المنطقي. أمّا في حال كان الكائن الذي استُدعيت عبره يحتوي أكثر من عنصر واحد (يحقق predicate في حال تمريرها) أو لا يحتوي أي واحد (يحقق predicate في حال تمريرها) فستعيد القيمة المعدومة null.