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

المراجعة الحالية بتاريخ 13:49، 8 سبتمبر 2018

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

البنية العامة

operator fun dec(): Byte

وجود الكلمة المفتاحيّة operator يدل على أنّ هذا التابع مرتبطٌ بمعامل تكرار (iteration operator).

القيمة المعادة

تعاد قيمة من النوع Byte تمثل القيمة المعطاة بعد انقاصها بمقدار 1.

أمثلة

استعمال الدالة ()inc لانقاص قيمة عددية:

fun main(args: Array<String>) {    
    val x = 3
    
    println(x.dec()) // 2
}

انظر أيضًا

الدالة compareTo()‎: توازن بين قيمة العنصر الذي استُدعيت معه والقيمة المُمرّرة إليه ثمَّ تعيد القيمة 0 إن كانا متساويين، أو قيمة سالبة إن كانت القيمة الأولى (قيمة العنصر الذي استُدعيت معه) أصغر من القيمة الثانية، أو قيمة موجبة إن كانت القيمة الأولى أكبر من القيمة الثانية.
الدالة inc()‎ : تزيد القيمة التي استُدعيت معها بمقدار 1 ثم تعيد القيمة الناتجة.
الدالة div()‎: تقسِّم العدد الذي استُدعي معه على العدد الممرّر إليها ثم تعيد الناتج.
الدالة minus()‎: تطرح العدد الممرّر إليها من العدد الذي استُدعي معها ثم تعيد الناتج.
الدالة plus()‎: تجمع العدد الممرّر إليها مع العدد الذي استُدعي معها ثم تعيد الناتج.
الدالة rangeTo()‎: تنشئ مجالًا يقع بين القيمة التي استدعيت معها والقيمة المُمرّرة إليها.
الدالة rem()‎: تحسب باقي عملية قسمة العدد الذي استُدعيت معه على العدد الممرّر إليها.
الدالة times()‎: تضرب العدد الممرّر إليها بالعدد المستدعى معها ثم تعيد الناتج.
الدالة unaryMinus()‎: تعيد القيمة السالبة المقابلة للقيمة التي استُدعيت معها.

مصادر

صفحة الدالة Byte.dec()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: الدالة <code>Byte.dec()‎</code> في لغة Kotlin}}</noinclude>
+<noinclude>{{DISPLAYTITLE: الدالة <code>Byte.dec()‎</code> في Kotlin}}</noinclude>
-تقارن الدالة<code>dec()‎</code> بين قيمة العنصر الذي استُدعيت عبره والقيمة المُمرّرة، إذ تعيد القيمة <code>0</code> إن كانا متساويين، أو تعيد قيمة سلبية إن كانت قيمة العنصر الذي استُدعيت عبره أصغر من القيمة المُمرّرة، أو تعيد قيمة موجبة إن كانت قيمة العنصر الذي استُدعيت عبره أكبر من القيمة المُمرّرة <nowiki/><nowiki/>.
+تنقص الدالة <code>dec()‎</code> القيمة التي استُدعيت معها بمقدار 1 ثم تعيد القيمة الناتجة.
 ==البنية العامة==
 <syntaxhighlight lang="kotlin">
-operator fun compareTo(other: Byte): Int
+operator fun dec(): Byte
-operator fun compareTo(other: Short): Int
-operator fun compareTo(other: Int): Int
+</syntaxhighlight>وجود الكلمة المفتاحيّة <code>operator</code> يدل على أنّ هذا التابع مرتبطٌ بمعامل تكرار (iteration operator).
-operator fun compareTo(other: Long): Int
-operator fun compareTo(other: Float): Int
+==القيمة المعادة==
-operator fun compareTo(other: Double): Int
+تعاد قيمة من النوع <code>Byte</code> تمثل القيمة المعطاة بعد انقاصها بمقدار 1.
-</syntaxhighlight>
-==القيمة المُعادة==
-قيمة عددية.
 ==أمثلة==
-===استخدام الدالة <code>()dec</code>===
+استعمال الدالة <code>()inc</code> لانقاص قيمة عددية:<nowiki/><syntaxhighlight lang="kotlin">
-تعرّف الشيفرة الآتية عددين <nowiki/>باسم <code>x</code> و <code>y</code> ، ثم تستخدم الدالة<code>()dec</code> على x وتمرر <code>y</code>  كوسيط للمقارنة بينهما، ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
 fun main(args: Array<String>) {
-     val x = 5
+     val x = 3
-    val y = 4
-     println(x.compareTo(y) )// 1
+     println(x.dec()) // 2
 }
 </syntaxhighlight>
-==أنظر أيضًا==
+==انظر أيضًا==
-*<code>[[Kotlin/Boolean/or|or()]]</code>‎ : تقوم بالعملية المنطقة <code>or</code> بين قيمتين منطقيتين، وعلى خلاف المعامل <code>||،</code> فهذه الدالة تتحقق من كلا القيمتين المنطقيتين.
+*الدالة <code>[[Kotlin/Byte/compareTo|compareTo()]]</code>‎: توازن  بين قيمة العنصر الذي استُدعيت معه والقيمة المُمرّرة إليه ثمَّ تعيد القيمة 0 إن كانا متساويين، أو قيمة سالبة إن كانت القيمة الأولى (قيمة العنصر الذي استُدعيت معه) أصغر من القيمة الثانية، أو قيمة موجبة إن كانت القيمة الأولى أكبر من القيمة الثانية.
+* الدالة <code>[[Kotlin/Byte/inc|inc()]]</code>‎ : تزيد القيمة التي استُدعيت معها بمقدار 1 ثم تعيد القيمة الناتجة.
+* الدالة <code>[[Kotlin/Byte/div|div()]]</code>‎: تقسِّم العدد الذي استُدعي معه على العدد الممرّر إليها ثم تعيد الناتج.
+* الدالة <code>[[Kotlin/Byte/minus|minus()‎]]</code>: تطرح العدد الممرّر إليها من العدد الذي استُدعي معها ثم تعيد الناتج.
+* الدالة <code>[[Kotlin/Byte/plus|plus()‎]]</code>: تجمع العدد الممرّر إليها مع العدد الذي استُدعي معها ثم تعيد الناتج.
+* الدالة <code>[[Kotlin/Byte/rangeTo|rangeTo()‎]]</code>: تنشئ مجالًا يقع بين القيمة التي استدعيت معها والقيمة المُمرّرة إليها.
+* الدالة <code>[[Kotlin/Byte/rem|rem()‎]]</code>: تحسب باقي عملية قسمة العدد الذي استُدعيت معه على العدد الممرّر إليها.
+* الدالة <code>[[Kotlin/Byte/times|times()‎]]</code>: تضرب العدد الممرّر إليها بالعدد المستدعى معها ثم تعيد الناتج.
+* الدالة <code>[[Kotlin/Byte/unaryMinus|unaryMinus()‎]]</code>: تعيد القيمة السالبة المقابلة للقيمة التي استُدعيت معها.
 ==مصادر==
-* [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-byte/compare-to.html الدالة  Byte.dec()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+* [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-byte/compare-to.html صفحة الدالة Byte.dec()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
-[[تصنيف:Kotlin Functions]]
+[[تصنيف:Kotlin Function]]
+[[تصنيف:Kotlin Byte]]