الفرق بين المراجعتين لصفحة: «Kotlin/Byte»
لا ملخص تعديل |
جميل-بيلوني (نقاش | مساهمات) طلا ملخص تعديل |
||
(7 مراجعات متوسطة بواسطة مستخدمين اثنين آخرين غير معروضة) | |||
سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE:الصنف <code>Byte</code> في Kotlin}}</noinclude> | يمثل الصنف <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]] === | |||
توازن الدالة <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> القيمة التي استُدعيت معها بمقدار 1 ثم تعيد القيمة الناتجة. | |||
=== <code>[[Kotlin/Byte/div|div]]</code> === | === <code>[[Kotlin/Byte/div|div]]</code> === | ||
تقسِّم الدالة <code>div()</code> العدد الذي استُدعي معه على العدد الممرّر إليها ثم تعيد الناتج. | |||
=== <code>[[Kotlin/Byte/inc|inc]]</code> === | === <code>[[Kotlin/Byte/inc|inc]]</code> === | ||
تزيد الدالة <code>inc()</code> القيمة التي استُدعيت معها بمقدار 1 ثم تعيد القيمة الناتجة. | |||
=== <code>[[Kotlin/Byte/minus|minus]]</code> === | === <code>[[Kotlin/Byte/minus|minus]]</code> === | ||
تطرح الدالة <code>minus()</code> العدد الممرّر إليها من العدد الذي استُدعي معها ثم تعيد الناتج. | |||
=== <code>[[Kotlin/Byte/plus|plus]]</code> === | === <code>[[Kotlin/Byte/plus|plus]]</code> === | ||
تجمع الدالة <code>plus()</code> العدد الممرّر إليها مع العدد الذي استُدعي معها ثم تعيد الناتج. | |||
=== <code>[[Kotlin/Byte/rangeTo|rangeTo]]</code> === | === <code>[[Kotlin/Byte/rangeTo|rangeTo]]</code> === | ||
تنشئ الدالة <code>rangeTo()</code> مجالًا يقع بين القيمة التي استدعيت معها والقيمة المُمرّرة إليها. | |||
=== <code>[[Kotlin/Byte/rem|rem]]</code> === | === <code>[[Kotlin/Byte/rem|rem]]</code> === | ||
تحسب الدالة <code>rem()</code> باقي عملية قسمة العدد الذي استُدعيت معه على العدد الممرّر إليها. | |||
=== <code>[[Kotlin/Byte/times|times]]</code> === | === <code>[[Kotlin/Byte/times|times]]</code> === | ||
تضرب الدالة <code>times()</code> العدد الممرّر إليها بالعدد المستدعى معها ثم تعيد الناتج. | |||
=== <code>[[Kotlin/Byte/toByte|toByte]]</code> === | === <code>[[Kotlin/Byte/toByte|toByte]]</code> === | ||
تحوّل الدالة <code>toByte()</code> العدد الذي استُدعي معها إلى عدد من النوع <code>[[Kotlin/Byte|Byte]]</code>، وهذا قد يؤدي إلى تقريب العدد أو اقتطاع جزءٍ منه. | |||
=== <code>[[Kotlin/Byte/toChar|toChar]]</code> === | === <code>[[Kotlin/Byte/toChar|toChar]]</code> === | ||
تحول الدالة <code>toChar()</code> القيمة العددية للكائن الذي استُدعي معها إلى الحرف المقابل في جدول ASCII، ويمكن تقطيعه إلى 16 بت إن كان ذلك ضروريًا. | |||
=== <code>[[Kotlin/Byte/toDouble|toDouble]]</code> === | === <code>[[Kotlin/Byte/toDouble|toDouble]]</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|Float]]</code>، وهذا قد يؤدي إلى تقريب العدد. | |||
=== <code>[[Kotlin/Byte/toInt|toInt]]</code> === | === <code>[[Kotlin/Byte/toInt|toInt]]</code> === | ||
تحول الدالة <code>toInt()</code> العدد الذي استُدعي معها إلى عدد من النوع <code>Int</code>، وهذا قد يؤدي إلى تقريب العدد أو اقتطاع جزءٍ منه. | |||
=== <code>[[Kotlin/Byte/toLong|toLong]]</code> === | === <code>[[Kotlin/Byte/toLong|toLong]]</code> === | ||
تحول الدالة <code>toLong()</code> العدد الذي استُدعي معها إلى عدد من النوع <code>Long</code>، وهذا قد يؤدي إلى تقريب العدد أو اقتطاع جزءٍ منه. | |||
=== <code>[[Kotlin/Byte/toShort|toShort]]</code> === | === <code>[[Kotlin/Byte/toShort|toShort]]</code> === | ||
تحوِّل الدالة <code>toShort()</code> العدد الذي استُدعي معها إلى عدد من النوع <code>Short</code>، وهذا قد يؤدي إلى تقريب العدد أو اقتطاع جزءٍ منه. | |||
=== <code>[[Kotlin/Byte/unaryMinus|unaryMinus]]</code> === | === <code>[[Kotlin/Byte/unaryMinus|unaryMinus]]</code> === | ||
تعيد الدالة <code>unaryMinus()</code> القيمة السالبة المقابلة للقيمة التي استُدعيت معها. | |||
=== <code>[[Kotlin/Byte/unaryPlus|unaryPlus]]</code> === | === <code>[[Kotlin/Byte/unaryPlus|unaryPlus]]</code> === | ||
تعيد الدالة <code>unaryPlus()</code> القيمة التي استدعيت معها. | |||
== الخاصيات المصاحبة (Companion Object Properties) == | |||
=== <code>[[Kotlin/Byte/MAX_VALUE|MAX_VALUE]]</code> === | === <code>[[Kotlin/Byte/MAX_VALUE|MAX_VALUE]]</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>Byte.MIN_VALUE</code> أصغر قيمة يمكن تخزينها في النوع <code>[[Kotlin/Byte|Byte]]</code>. | |||
== الدوال الإضافية (Extension Functions) == | |||
=== <code>[[Kotlin/experimental/and|and]]</code> === | |||
=== <code>[[Kotlin/ranges/coerceAtLeast|coerceAtLeast]]</code> === | |||
=== <code>[[Kotlin/ranges/coerceAtMost|coerceAtMost]]</code> === | |||
=== <code>[[Kotlin/ranges/coerceIn|coerceIn]]</code> === | |||
=== <code>[[Kotlin/ranges/downTo|downTo]]</code> === | === <code>[[Kotlin/ranges/downTo|downTo]]</code> === | ||
تنشئ الدالة <code>downTo()</code> مجالًا متدرجًا (progression) يبدًأ من القيمة القصوى التي استُدعيت معها وينحدر تنازليًّا حتى يصل إلى القيمة الممرّرة إليها. | |||
=== <code>[[Kotlin/experimental/inv|inv]]</code> === | |||
=== <code>[[Kotlin/experimental/or|or]]</code> === | |||
=== <code>[[Kotlin/kotlin.text/toString|toString]]</code> === | |||
تحول الدالة <code>toString()</code> العدد الذي استٌدعي معها وفقًا لأساس مُحدّد إلى سلسلة نصية. | |||
=== <code>[[Kotlin/ranges/until|until]]</code> === | === <code>[[Kotlin/ranges/until|until]]</code> === | ||
تنشئ الدالة <code>until()</code> مجالًا (range) تصاعديًا يبدأ القيمة التي استُدعيت معها وحتى القيمة الممرّرة إليها (لا تدخل هذه القيمة ضمن المجال). | |||
=== <code>[[Kotlin/experimental/xor|xor]]</code> === | |||
=== <code>[[Kotlin/ | |||
== مصادر == | |||
* [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-byte/index.html صفحة الصنف Byte في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.] | |||
[[تصنيف:Kotlin]] | [[تصنيف:Kotlin]] | ||
[[تصنيف:Kotlin | [[تصنيف: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) تصاعديًا يبدأ القيمة التي استُدعيت معها وحتى القيمة الممرّرة إليها (لا تدخل هذه القيمة ضمن المجال).