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

المراجعة الحالية بتاريخ 11:50، 9 سبتمبر 2018

تحسب الدالة rem()‎ باقي عملية قسمة العدد العشري (double) الذي استُدعي معها على العدد الممرّر إليها.

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

operator fun rem(other: Byte): Float 
operator fun rem(other: Short): Float 
operator fun rem(other: Int): Float 
operator fun rem(other: Long): Float
operator fun rem(other: Float): Float
operator fun rem(other: Double): Double

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

المعاملات

`other`

العدد الآخر الذي ستُجرَى عليه العملية.

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

يعاد عدد عشري يحوي باقي عملية قسمة العدد العشري المعطى على العدد other الممرّر. إن كان نوع العدد other عددًا عشريًّا مضاعفًا، فسيكون نوع العدد المعاد -الذي يمثل باقي القسمة- مثل نوعه.

أمثلة

استعمال الدالة ()rem لحساب باقي قسمة عددين عشريين:

fun main(args: Array<String>) {    
    val x: Float = 52.3f
    val y: Float = 10.43f
    
    print(x.rem(y)) // 0.14999771
}

انظر أيضًا

الدالة compareTo()‎: توازن بين عدد عشري (float) وعدد آخر ثمَّ تعيد القيمة 0 إن كانا متساويين، أو قيمة سالبة إن كان العدد الأول (العدد الذي استُدعي مع الدالة) أصغر من العدد الثاني الممرر إليها، أو قيمة موجبة إن كان العدد الأول أكبر من العدد الثاني.

الدالة dec()‎: تُنقِص العدد العشري (float) الذي استُدعي معها بمقدار 1 ثمَّ تعيد القيمة الناتجة.
الدالة inc()‎ : تزيد العدد العشري (float) الذي استُدعي معها بمقدار 1 ثمَّ تعيد القيمة الناتجة.
الدالة div()‎: تقسِّم العدد العشري (float) الذي استُدعي معها على العدد المُمرّر إليها ثمَّ تعيد الناتج.
الدالة minus()‎: تطرح العدد الممرّر إليها من العدد العشري (float) الذي استُدعي معها ثم تعيد الناتج.
الدالة plus()‎: تجمع العدد العشري (float) الذي استُدعي معها مع العدد الممرّر إليها ثم تعيد الناتج.
الدالة times()‎: تضرب العدد الممرّر إليها بالعدد العشري (float) المستدعى معها ثمَّ تعيد الناتج.

مصادر

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

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