كوتلن

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

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

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

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

class Float : Number, Comparable<Float>

الدوال

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

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

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

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

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

operator fun compareTo(other: Double): Int

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

المعاملات

other

العدد الآخر المراد موازنته.

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

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

أمثلة

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

fun main(args: Array<String>) {    
		val x: Float = 5.5f
		val y: Float = 4.45f

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

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

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

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

operator fun dec(): Float

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

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

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

أمثلة

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

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

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

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

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

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

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

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

المعاملات

other

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

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

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

أمثلة

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

fun main(args: Array<String>) {    
		val x: Float  = 4.4f
		val y: Float  = 2.3f

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

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

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

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

operator fun inc(): Float

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

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

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

أمثلة

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

fun main(args: Array<String>) {    
		val x: Float = 5.54f

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

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

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

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

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

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

المعاملات

other

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

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

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

أمثلة

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

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

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

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

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

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

val NaN: Float

أمثلة

استعمال الثابت Float.NaN لطباعة قيمة غير عددية للنوع Float:

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

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

يمثل الثابت Float.NEGATIVE_INFINITY قيمة سالبة لا نهائية (infinity) لعدد عشري (float).

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

val NEGATIVE_INFINITY: Float

أمثلة

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

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

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

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

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

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

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

المعاملات

other

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

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

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

أمثلة

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

fun main(args: Array<String>) {    
		val x: Float = 4.2f
		val y: Float = 0.45f

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

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

يمثل الثابت Float.POSITIVE_INFINITY قيمة موجبة لا نهائية (infinity) لعدد عشري (float).

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

val POSITIVE_INFINITY: Float

أمثلة

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

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

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

تحسب الدالة 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
		}

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

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

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

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

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

المعاملات

other

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

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

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

أمثلة

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

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

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

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

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

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

fun toByte(): Byte

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

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

أمثلة

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

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

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

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

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

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

fun toChar(): Char

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

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

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

أمثلة

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

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

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

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

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

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

fun toDouble(): Double

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

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

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

أمثلة

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

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

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

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

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

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

fun toFloat(): Float

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

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

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

أمثلة

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

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

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

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

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

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

fun toInt(): Int

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

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

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

أمثلة

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

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

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

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

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

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

fun toLong(): Long

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

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

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

أمثلة

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

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

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

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

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

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

fun toShort(): Short

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

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

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

أمثلة

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

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

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

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

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

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

operator fun unaryMinus(): Float

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

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

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

أمثلة

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

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

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

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

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

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

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

operator fun unaryPlus(): Float

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

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

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

أمثلة

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

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

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

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

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

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

const val MAX_VALUE: Float

أمثلة

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

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

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

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

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

val MIN_VALUE: Float

أمثلة

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

fun main(args: Array<String>) {    
		println(Float.MIN_VALUE ) // 1.4E-45
		}

مصادر

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

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