كوتلن

دوال الكلاس ‎‎Double‎ في كوتلن | Kotlin Double‎

سجين القدر
اخر تحديث :

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

يمثل الصنف Double عددًا عشريًّا مضاعفًا (دقة مضاعفة للأعداد بعد الفاصلة [double-precision floating point]) بحجم 64 بت مطابقًا للمعيار IEEE 754. في بيئة التشغيل JVM، القيم غير المعدومة (non-nullable) لهذا النوع تُمثَّل كقيم للنوع double الأساسي.

class Double : Number, Comparable<Double>

دوال الكلاس ‎‎Double‎ في كوتلن

الدالة Double.compareTo()‎ في Kotlin

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

استُبدِل بهذه الدالة الدالة Comparable.compareTo()‎.

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

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

حلت الدالة Comparable.compareTo()‎ مكان الأشكال السابقة من هذه الدالة.

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

المعاملات

other

العدد الآخر المراد موازنته مع العدد العشري المضاعف المعطى.

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

تعاد القيمة 0 إن كان العدد المعطى متساويًا مع العدد other الممرر، أو تعاد قيمة سالبة إن كان العدد الأول (القيمة المعطاة) أصغر من العدد الثاني (قيمة الوسيط other)، أو تعاد قيمة موجبة إن كان العدد الأول أكبر من العدد الثاني.

أمثلة

استعمال الدالة ()compareTo للموازنة بين عددين عشريين:

fun main(args: Array<String>) {    
	  val x = 3.44
	  val y = 5.4

	  println(x.compareTo(y)) // -1
	  }

الدالة Double.dec()‎ في Kotlin

تنقص الدالة dec()‎ العدد العشري المضاعف (double) الذي استُدعي معها بمقدار 1 ثمَّ تعيد القيمة الناتجة.

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

operator fun dec(): Double

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

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

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

أمثلة

استعمال الدالة ()dec لإنقاص عدد عشري مضاعف بمقدار 1 فقط:

fun main(args: Array<String>) {    
	  val x: Double = 3.4

	  println(x.dec()) // 2.4
	  }

الدالة Double.div()‎ في Kotlin

تقسِّم الدالة div()‎ العدد العشري المضاعف (double) الذي استُدعي معها على العدد الممرّر إليها ثم تعيد الناتج.

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

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

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

المعاملات

other

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

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

يعاد عدد عشري مضاعف ناتج قسمة العدد العدد العشري المضاعف المعطى على العدد other الممرّر.

أمثلة

استعمال الدالة ()div لقسمة عدد عشري مضاعف على عدد صحيح:

fun main(args: Array<String>) {
	  val x: Double = 4.987654321
	  val y: Int = 2

	  println(x.div(y)) // 2.4938271605
	  }

الدالة Double.inc()‎ في Kotlin

تزيد الدالة inc()‎ العدد العشري المضاعف (double) الذي استُدعي معها بمقدار 1 ثمَّ تعيد القيمة الناتجة.

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

operator fun inc(): Double

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

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

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

أمثلة

استعمال الدالة ()dec لزيادة عدد عشري مضاعف بمقدار 1 فقط:

fun main(args: Array<String>) {    
	  val x: Double = 5.67

	  println(x.inc()) // 6.67
	  }

الثابت Double.MAX_VALUE في Kotlin

يمثل الثابت Double.MAX_VALUE أكبر قيمة موجبة نهائية (finite) لعدد عشري مضاعف (double).

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

val MAX_VALUE: Double

أمثلة

استخدام الثابت Double.MAX_VALUE لمعرفة أكبر عدد عشري مضاعف موجب يمكن استعماله:

fun main(args: Array<String>) {    
	  println(Double.MAX_VALUE) // 1.7976931348623157E308
	  }

الثابت Double.MIN_VALUE في Kotlin

يمثّل الثابت Double.MIN_VALUE أًصغر قيمة موجبة غير صفرية يمكن أن يأخذها عدد عشري مضاعف (double).

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

const val MIN_VALUE: Double

أمثلة

استخدام الثابتة Double.MIN_VALUE لمعرفة أصغر قيمة موجبة غير صفرية يمكن استعمالها مع عدد عشري مضاعف:

fun main(args: Array<String>) {    
	  println(Double.MIN_VALUE) // 4.9E-324
	  }

الدالة Double.minus()‎ في Kotlin

تطرح الدالة minus()‎ العدد الممرّر إليها من العدد العشري المضاعف (double) الذي استُدعي معها ثم تعيد الناتج.

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

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

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

المعاملات

other

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

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

يعاد عدد عشري مضاعف يحوي ناتج طرح العدد other الممرّر من العدد العشري المضاعف المعطى.

أمثلة

استعمال الدالة ()minus لطرح عددين عشريين من النوع Double:

fun main(args: Array<String>) {    
	  val x: Double  = 4.45
	  val y: Double  = 2.322

	  println(x.minus(y)) // 2.128
	  }

الثابت Double.NaN في Kotlin

يمثل الثابت Double.NaN قيمة غير عددية (Not a Number) لعدد من النوع Double.

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

val NaN: Float

أمثلة

استعمال الثابت Float.NaN لطباعة القيمة NaN:

fun main(args: Array<String>) {    
	  println(Float.NaN) // NaN
	  }

الثابت Double.NEGATIVE_INFINITY في Kotlin

يمثّل الثابت Double.NEGATIVE_INFINITY قيمة سالبة لا نهائية (infinity) لعدد عشري مضاعف (double).

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

val NEGATIVE_INFINITY: Double

أمثلة

استخدام الثابت Double.NEGATIVE_INFINITY لطباعة قيمة سالبة لا نهائية لعدد عشري مضاعف:

fun main(args: Array<String>) {    
	  println(Double.NEGATIVE_INFINITY) // -Infinity
	  }

الدالة Double.plus()‎ في Kotlin

تجمع الدالة plus()‎ العدد العشري المضاعف (double) الذي استُدعي معها مع العدد الممرّر إليها ثم تعيد الناتج.

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

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

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

المعاملات

other

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

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

يعاد عدد عشري مضاعف يحوي ناتج جمع العدد العشري المضاعف المعطى مع العدد other الممرّر.

أمثلة

استعمال الدالة ()plus لجمع عددين عشريين من النوع Double:

fun main(args: Array<String>) {
	  val x: Double = 4.987654321
	  val y: Short = 15

	  print(x.plus(y))// 19.987654321
	  }

الثابت Double.POSITIVE_INFINITY في Kotlin

يمثل الثابت Double.POSITIVE_INFINITY قيمة موجبة لا نهائية (infinity) لعدد عشري مضاعف (double).

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

val POSITIVE_INFINITY: Double

أمثلة

استخدام الثابت Double.POSITIVE_INFINITY لطباعة قيمة موجبة لا نهائية لعدد عشري مضاعف:

fun main(args: Array<String>) {    
	  println(Double.POSITIVE_INFINITY ) // Infinity
	  }

الدالة Double.rem()‎ في Kotlin

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

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

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

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

المعاملات

other

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

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

يعاد عدد عشري مضاعف يحوي باقي عملية قسمة العدد العشري المضاعف المعطى على العدد other الممرّر.

أمثلة

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

fun main(args: Array<String>) {    
	  val x: Double = 52.3
	  val y: Double = 10.43

	  print(x.rem(y)) // 0.14999999999999858
	  }

الدالة Double.times()‎ في Kotlin

تضرب الدالة times()‎ العدد الممرّر إليها بالعدد العشري المضاعف (double) المستدعى معها ثم تعيد الناتج.

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

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

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

المعاملات

other

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

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

يعاد عدد عشري مضاعف يحوي ناتج ضرب العدد other الممرّر بالعدد العشري المضاعف المعطى.

أمثلة

استعمال الدالة ()times لضرب عدين من النوع Double:

fun main(args: Array<String>) {    
	  val x: Double = 4.4
	  val y: Double = 2.0

	  print(x.times(y)) // 8.8
	  }

الدالة Double.toByte()‎ في Kotlin

تحوّل الدالة toByte()‎ العدد العشري المضاعف (double) الذي استُدعي معها إلى عدد من النوع Byte. هذا قد يؤدي إلى تدوير العدد المراد تحويله أو اقتطاع جزءٍ منه.

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

fun toByte(): Byte

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

يعاد عدد من النوع Byte يحوي العدد العشري المضاعف المعطى.

أمثلة

استعمال الدالة ()toByte لتحويل عدد عشري مضاعف إلى عدد من النوع Byte:

fun main(args: Array<String>) {    
	  val x: Double = 52.43

	  print(x.toByte()) // 52
	  }

الدالة Double.toChar()‎ في Kotlin

تحول الدالة toChar()‎ العدد العشري المضاعف (double) الذي استُدعي معها إلى المحرف الذي يقابله (أي من النوع Char) بعد اقتطاعه إلى 16 بت إن تطلب ذلك.

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

fun toChar(): Char

حلت الدالة Number.toChar()‎ مكان هذه الدالة.

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

يعاد المحرف الذي تساوي قيمته العددية العدد العشري المضاعف المعطى.

أمثلة

استعمال الدالة ()toChar لتحويل عدة أعداد عشرية مضاعفة إلى ما يقابلها من محارف:

fun main(args: Array<String>) {    
	  val x: Double = 97.4
	  val y: Double = 50.2
	  val z: Double = 101.34

	  println(x.toChar()) // a
	  println(y.toChar()) // 2
	  println(z.toChar()) // e
	  }

الدالة Double.toDouble()‎ في Kotlin

تحوّل الدالة toDouble()‎ العدد الذي استُدعي معها إلى عدد عشري مضاعف (أي من النوع Double). هذا قد يؤدي إلى تدوير العدد المراد تحويله.

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

fun toDouble(): Double

حلت الدالة Number.toDouble()‎ مكان هذه الدالة.

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

يعاد عدد عشري مضاعف (من النوع Double) يحوي العدد المعطى المراد تحويله.

أمثلة

استعمال الدالة ()toDouble لتحويل العدد 52.44:

fun main(args: Array<String>) {    
	  val x: Double = 52.44

	  println(x.toDouble()) // 52.44
	  }

الدالة Double.toFloat()‎ في Kotlin

تحوّل الدالة toFloat()‎ العدد العشري المضاعف (double) الذي استُدعي معها إلى عدد عشري (أي من النوع Float). هذا قد يؤدي إلى تدوير العدد المراد تحويله.

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

fun toFloat(): Float

حلت الدالة Number.toFloat()‎ مكان هذه الدالة.

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

يعاد عدد عشري (من النوع Float) يحوي العدد العشري المضاعف المعطى.

أمثلة

استعمال الدالة ()toFloat لتحويل عدد عشري مضاعف إلى عدد عشري:

fun main(args: Array<String>) {    
	  val x : Double = 52.0

	  print(x.toFloat() )// 52.0
	  }

الدالة Double.toInt()‎ في Kotlin

تحوّل الدالة toInt()‎ العدد العشري المضاعف (double) الذي استُدعي معها إلى عدد صحيح (أي من النوع Int). هذا قد يؤدي إلى تدوير العدد المراد تحويله أو اقتطاع جزءٍ منه.

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

fun toInt(): Int

حلت الدالة Number.toInt()‎ مكان هذه الدالة.

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

يعاد عدد صحيح (من النوع Int) يحوي العدد العشري المضاعف المراد تحويله.

أمثلة

استعمال الدالة ()toInt لتحويل عدد عشري مضاعف إلى عدد صحيح:

fun main(args: Array<String>) {    
	  val x: Double = 52.6

	  println( x.toInt()) // 52
	  }

الدالة Double.toLong()‎ في Kotlin

تحوّل الدالة toLong()‎ العدد العشري المضاعف (double) الذي استُدعي معها إلى عدد من النوع Long. هذا قد يؤدي إلى تدوير العدد المراد تحويله أو اقتطاع جزءٍ منه.

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

fun toLong(): Long

حلت الدالة Number.toLong()‎ مكان هذه الدالة.

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

يعاد عدد من النوع Long يحوي العدد العشري المضاعف المراد تحويله.

أمثلة

استعمال الدالة ()toLong لتحويل عدد من النوع Double إلى النوع Long:

fun main(args: Array<String>) {    
	  val x: Double = 52.5

	  println(x.toLong()) // 52
	  }

الدالة Double.toShort()‎ في Kotlin

تحوّل الدالة toShort()‎ العدد العشري المضاعف (double) الذي استُدعي معها إلى عدد من النوع Short (عدد قصير). هذا قد يؤدي إلى تدوير العدد المراد تحويله أو اقتطاع جزءٍ منه.

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

fun toShort(): Short

حلت الدالة Number.toShort()‎ مكان هذه الدالة.

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

يعاد عدد من النوع Short يحوي العدد العشري المضاعف المراد تحويله.

أمثلة

استعمال الدالة ()toShort لتحويل عدد من النوع Double إلى النوع Short:

fun main(args: Array<String>) {    
	  val x: Double = 52.7

	  println(x.toShort()) // 52 
	  }

الدالة Double.unaryMinus()‎ في Kotlin

تعيد الدالة unaryMinus()‎ القيمة السالبة المقابلة للعدد العشري المضاعف (double) الذي استُدعي معها.

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

operator fun unaryMinus(): Double

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

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

يعاد عدد عشري مضاعف يمثل القيمة السالبة للعدد العشري المضاعف المعطى.

أمثلة

استعمال الدالة ()unaryMinus لإعادة قيمة سالبة لعدد عشري مضاعف موجب وآخر سالب:

fun main(args: Array<String>) {
	  val x: Double = 52.5

	  val y = x.unaryMinus()
	  println(y) // -52.5

	  val z = y.unaryMinus()
	  println(z) // 52.5
	  }

الدالة Double.unaryPlus()‎ في Kotlin

تعيد الدالة unaryPlus()‎ العدد العشري المضاعف (double) الذي استُدعي معها.

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

operator fun unaryPlus(): Double

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

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

يعاد العدد نفسه المعطى.

أمثلة

استعمال الدالة ()unaryPlus لإعادة القيمة المستدعاة معها:

fun main(args: Array<String>) {    
	  val x: Double = 52.54

	  println(x.unaryPlus()) // 52.54
	  }

مصادر

تعديل المقال
الأقسام

مقالات قد تهمك

تعليقات