الفرق بين المراجعتين لصفحة: «Kotlin/Float»
أنشأ الصفحة ب'Links === <code>compareTo</code> === === <code>dec</code> === === <code>div</code> === === <code>K...' |
جميل-بيلوني (نقاش | مساهمات) طلا ملخص تعديل |
||
(4 مراجعات متوسطة بواسطة مستخدمين اثنين آخرين غير معروضة) | |||
سطر 1: | سطر 1: | ||
يمثل الصنف <code>Float</code> عددًا عشريًّا (دقة أحادية للأعداد بعد الفاصلة [single-precision floating point]) بحجم 32 بت مطابقًا للمعيار <nowiki/>[[wikipedia:IEEE_754|IEEE 754]]. في بيئة التشغيل JVM، القيم غير المعدومة (non-nullable) لهذا النوع تُمثَّل كقيم للنوع <code>float</code> الأساسي.<syntaxhighlight lang="kotlin"> | |||
class Float : Number, Comparable<Float> | |||
</syntaxhighlight> | |||
== الدوال == | |||
<noinclude>{{DISPLAYTITLE:الصنف <code>Float</code> في Kotlin}}</noinclude> | |||
=== <code>[[Kotlin/Float/compareTo|compareTo]]</code> === | === <code>[[Kotlin/Float/compareTo|compareTo]]</code> === | ||
توازن الدالة <code>compareTo()</code> بين <nowiki/>[[Kotlin/Float|عدد عشري]] (float) وعدد آخر ثمَّ تعيد القيمة 0 إن كانا متساويين، أو قيمة سالبة إن كان العدد الأول (العدد الذي استُدعي مع الدالة) أصغر من العدد الثاني الممرر إليها، أو قيمة موجبة إن كان العدد الأول أكبر من العدد الثاني. | |||
=== <code>[[Kotlin/Float/dec|dec]]</code> === | === <code>[[Kotlin/Float/dec|dec]]</code> === | ||
تنقص الدالة <code>dec()</code> العدد العشري (float) الذي استُدعي معها بمقدار 1 ثمَّ تعيد القيمة الناتجة. | |||
=== <code>[[Kotlin/Float/div|div]]</code> === | === <code>[[Kotlin/Float/div|div]]</code> === | ||
تقسِّم الدالة <code>div()</code> <nowiki/>[[Kotlin/Float|العدد العشري]] (float) الذي استُدعي معها على العدد المُمرّر إليها ثمَّ تعيد الناتج. | |||
=== <code>[[Kotlin/Float/inc|inc]]</code> === | === <code>[[Kotlin/Float/inc|inc]]</code> === | ||
تزيد الدالة <code>inc()</code> <nowiki/>[[Kotlin/Float|العدد العشري]] (float) الذي استُدعي معها بمقدار 1 ثمَّ تعيد القيمة الناتجة. | |||
=== <code>[[Kotlin/Float/minus|minus]]</code> === | === <code>[[Kotlin/Float/minus|minus]]</code> === | ||
تطرح الدالة <code>minus()</code> العدد الممرّر إليها من <nowiki/>[[Kotlin/Float|العدد العشري]] (float) الذي استُدعي معها ثم تعيد الناتج. | |||
=== <code>[[Kotlin/Float/plus|plus]]</code> === | === <code>[[Kotlin/Float/plus|plus]]</code> === | ||
تجمع الدالة <code>plus()</code> <nowiki/>[[Kotlin/Float|العدد العشري]] (float) الذي استُدعي معها مع العدد الممرّر إليها ثم تعيد الناتج. | |||
=== <code>[[Kotlin/Float/rem|rem]]</code> === | === <code>[[Kotlin/Float/rem|rem]]</code> === | ||
تحسب الدالة <code>rem()</code> باقي عملية قسمة <nowiki/>[[Kotlin/Float|العدد العشري]] (double) الذي استُدعي معها على العدد الممرّر إليها. | |||
=== <code>[[Kotlin/Float/times|times]]</code> === | === <code>[[Kotlin/Float/times|times]]</code> === | ||
تضرب الدالة <code>times()</code> العدد الممرّر إليها <nowiki/>[[Kotlin/Float|بالعدد العشري]] (float) المستدعى معها ثمَّ تعيد الناتج. | |||
=== <code>[[Kotlin/Float/toByte|toByte]]</code> === | === <code>[[Kotlin/Float/toByte|toByte]]</code> === | ||
تحوّل الدالة <code>toByte()</code> <nowiki/>[[Kotlin/Float|العدد العشري]] (float) الذي استُدعي معها إلى عدد من النوع <code>[[Kotlin/Byte|Byte]]</code>. هذا قد يؤدي إلى تدوير العدد المراد تحويله أو اقتطاع جزءٍ منه. | |||
=== <code>[[Kotlin/Float/toChar|toChar]]</code> === | === <code>[[Kotlin/Float/toChar|toChar]]</code> === | ||
تحول الدالة <code>toChar()</code> <nowiki/>[[Kotlin/Float|العدد العشري]] (float) الذي استُدعي معها إلى المحرف الذي يقابله (أي من النوع <code>[[Kotlin/Char|Char]]</code>) بعد اقتطاعه إلى 16 بت إن تطلب ذلك. | |||
=== <code>[[Kotlin/Float/toDouble|toDouble]]</code> === | === <code>[[Kotlin/Float/toDouble|toDouble]]</code> === | ||
تحوّل الدالة <code>toDouble()</code> <nowiki/>[[Kotlin/Float|العدد العشري]] الذي استُدعي معها إلى عدد عشري مضاعف (أي من النوع <code>[[Kotlin/Double|Double]]</code>). هذا قد يؤدي إلى تدوير العدد المراد تحويله. | |||
=== <code>[[Kotlin/Float/toFloat|toFloat]]</code> === | === <code>[[Kotlin/Float/toFloat|toFloat]]</code> === | ||
تحوّل الدالة <code>toFloat()</code> العدد الذي استُدعي معها إلى عدد عشري (أي من النوع <code>[[Kotlin/Float|Float]]</code>). هذا قد يؤدي إلى تدوير العدد المراد تحويله. | |||
=== <code>[[Kotlin/Float/toInt|toInt]]</code> === | === <code>[[Kotlin/Float/toInt|toInt]]</code> === | ||
تحوّل الدالة <code>toInt()</code> <nowiki/>[[Kotlin/Float|العدد العشري]] (float) الذي استُدعي معها إلى عدد صحيح (أي من النوع <code>Int</code>). هذا قد يؤدي إلى تدوير العدد المراد تحويله أو اقتطاع جزءٍ منه. | |||
=== <code>[[Kotlin/Float/toLong|toLong]]</code> === | === <code>[[Kotlin/Float/toLong|toLong]]</code> === | ||
تحوّل الدالة <code>toLong()</code> <nowiki/>[[Kotlin/Float|العدد العشري]] (float) الذي استُدعي معها إلى عدد من النوع <code>Long</code> (عدد طويل). هذا قد يؤدي إلى تدوير العدد المراد تحويله أو اقتطاع جزءٍ منه. | |||
=== <code>[[Kotlin/Float/toShort|toShort]]</code> === | === <code>[[Kotlin/Float/toShort|toShort]]</code> === | ||
تحوّل الدالة <code>toShort()</code> <nowiki/>[[Kotlin/Float|العدد العشري]] (float) الذي استُدعي معها إلى عدد من النوع <code>Short</code> (عدد قصير). هذا قد يؤدي إلى تدوير العدد المراد تحويله أو اقتطاع جزءٍ منه. | |||
=== <code>[[Kotlin/Float/unaryMinus|unaryMinus]]</code> === | === <code>[[Kotlin/Float/unaryMinus|unaryMinus]]</code> === | ||
تعيد الدالة<code>unaryMinus()</code> القيمة السالبة المقابلة <nowiki/>[[Kotlin/Float|للعدد العشري]] (float) الذي استُدعي معها. | |||
=== <code>[[Kotlin/Float/unaryPlus|unaryPlus]]</code> === | === <code>[[Kotlin/Float/unaryPlus|unaryPlus]]</code> === | ||
تعيد الدالة <code>unaryPlus()</code> <nowiki/>[[Kotlin/Float|العدد العشري]] (float) الذي استُدعي معها. | |||
== الخاصيات المُصاحبة (Companion Object Properties) == | |||
=== <code>[[Kotlin/Float/MAX_VALUE|MAX_VALUE]]</code> === | === <code>[[Kotlin/Float/MAX_VALUE|MAX_VALUE]]</code> === | ||
يمثل الثابت <code>Float.MAX_VALUE</code> أكبر قيمة موجبة نهائية (finite) <nowiki/>[[Kotlin/Float|لعدد عشري]] (float). | |||
=== <code>[[Kotlin/Float/MIN_VALUE|MIN_VALUE]]</code> === | === <code>[[Kotlin/Float/MIN_VALUE|MIN_VALUE]]</code> === | ||
يمثل الثابت <code>Float.MIN_VALUE</code> أصغر قيمة موجبة غير صفرية يمكن أن يأخذها <nowiki/>[[Kotlin/Float|عدد عشري]] (float). | |||
=== <code>[[Kotlin/Float/NEGATIVE_INFINITY|NEGATIVE_INFINITY]]</code> === | === <code>[[Kotlin/Float/NEGATIVE_INFINITY|NEGATIVE_INFINITY]]</code> === | ||
يمثل الثابت <code>Float.NEGATIVE_INFINITY</code> قيمة سالبة لا نهائية (infinity) <nowiki/>[[Kotlin/Float|لعدد عشري]] (float). | |||
<code>[[Kotlin/Float/NaN|NaN]]</code> | |||
يمثل الثابت <code>Float.NaN</code> قيمة غير عددية (Not a Number) لعدد من النوع <code>[[Kotlin/Float|Float]]</code>. | |||
=== <code>[[Kotlin/Float/POSITIVE_INFINITY|POSITIVE_INFINITY]]</code> === | === <code>[[Kotlin/Float/POSITIVE_INFINITY|POSITIVE_INFINITY]]</code> === | ||
يمثل الثابت <code>Float.POSITIVE_INFINITY</code> قيمة موجبة لا نهائية (infinity) <nowiki/>[[Kotlin/Float|لعدد عشري]] (float). | |||
== الخاصيات الإضافية (Extension Properties) == | |||
=== <code>[[Kotlin/math/absoluteValue|absoluteValue]]</code> === | |||
===<code>[[Kotlin/math/sign|sign]]</code>=== | |||
===<code>[[Kotlin/math/ulp|ulp]]</code>=== | |||
== الدوال الإضافية (Extension Functions)== | |||
===<code>[[Kotlin/math/IEEErem|IEEErem]]</code>=== | |||
===<code>[[Kotlin/ranges/coerceAtLeast|coerceAtLeast]]</code>=== | |||
===<code>[[Kotlin/ranges/coerceAtMost|coerceAtMost]]</code>=== | |||
===<code>[[Kotlin/ranges/coerceIn|coerceIn]]</code>=== | |||
===<code>[[Kotlin/isFinite|isFinite]]</code>=== | |||
===<code>[[Kotlin/isInfinite|isInfinite]]</code>=== | |||
===<code>[[Kotlin/isNaN|isNaN]]</code>=== | |||
===<code>[[Kotlin/math/nextDown|nextDown]]</code>=== | |||
===<code>[[Kotlin/math/nextTowards|nextTowards]]</code>=== | |||
===<code>[[Kotlin/math/nextUp|nextUp]]</code>=== | |||
===<code>[[Kotlin/math/pow|pow]]</code>=== | |||
===<code>[[Kotlin/ranges/rangeTo|rangeTo]]</code>=== | |||
===<code>[[Kotlin/math/roundToInt|roundToInt]]</code>=== | |||
===<code>[[Kotlin/math/roundToLong|roundToLong]]</code>=== | |||
===<code>[[Kotlin/toBigDecimal|toBigDecimal]]</code>=== | |||
===<code>[[Kotlin/toBits|toBits]]</code>=== | |||
===<code>[[Kotlin/toRawBits|toRawBits]]</code>=== | |||
===<code>[[Kotlin/math/withSign|withSign]]</code>=== | |||
==الدوال الإضافية المصاحبة (Companion Object Extension Functions)== | |||
===<code>[[Kotlin/fromBits|fromBits]]</code>=== | |||
== مصادر== | |||
*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-double/index.html صفحة الصنف Float في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.] | |||
[[تصنيف:Kotlin]] | |||
[[تصنيف:Kotlin Class]] | |||
[[تصنيف:Kotlin Float]] | |||
المراجعة الحالية بتاريخ 12:13، 9 سبتمبر 2018
يمثل الصنف Float
عددًا عشريًّا (دقة أحادية للأعداد بعد الفاصلة [single-precision floating point]) بحجم 32 بت مطابقًا للمعيار IEEE 754. في بيئة التشغيل JVM، القيم غير المعدومة (non-nullable) لهذا النوع تُمثَّل كقيم للنوع float
الأساسي.
class Float : Number, Comparable<Float>
الدوال
compareTo
توازن الدالة compareTo()
بين عدد عشري (float) وعدد آخر ثمَّ تعيد القيمة 0 إن كانا متساويين، أو قيمة سالبة إن كان العدد الأول (العدد الذي استُدعي مع الدالة) أصغر من العدد الثاني الممرر إليها، أو قيمة موجبة إن كان العدد الأول أكبر من العدد الثاني.
dec
تنقص الدالة dec()
العدد العشري (float) الذي استُدعي معها بمقدار 1 ثمَّ تعيد القيمة الناتجة.
div
تقسِّم الدالة div()
العدد العشري (float) الذي استُدعي معها على العدد المُمرّر إليها ثمَّ تعيد الناتج.
inc
تزيد الدالة inc()
العدد العشري (float) الذي استُدعي معها بمقدار 1 ثمَّ تعيد القيمة الناتجة.
minus
تطرح الدالة minus()
العدد الممرّر إليها من العدد العشري (float) الذي استُدعي معها ثم تعيد الناتج.
plus
تجمع الدالة plus()
العدد العشري (float) الذي استُدعي معها مع العدد الممرّر إليها ثم تعيد الناتج.
rem
تحسب الدالة rem()
باقي عملية قسمة العدد العشري (double) الذي استُدعي معها على العدد الممرّر إليها.
times
تضرب الدالة times()
العدد الممرّر إليها بالعدد العشري (float) المستدعى معها ثمَّ تعيد الناتج.
toByte
تحوّل الدالة toByte()
العدد العشري (float) الذي استُدعي معها إلى عدد من النوع Byte
. هذا قد يؤدي إلى تدوير العدد المراد تحويله أو اقتطاع جزءٍ منه.
toChar
تحول الدالة toChar()
العدد العشري (float) الذي استُدعي معها إلى المحرف الذي يقابله (أي من النوع Char
) بعد اقتطاعه إلى 16 بت إن تطلب ذلك.
toDouble
تحوّل الدالة toDouble()
العدد العشري الذي استُدعي معها إلى عدد عشري مضاعف (أي من النوع Double
). هذا قد يؤدي إلى تدوير العدد المراد تحويله.
toFloat
تحوّل الدالة toFloat()
العدد الذي استُدعي معها إلى عدد عشري (أي من النوع Float
). هذا قد يؤدي إلى تدوير العدد المراد تحويله.
toInt
تحوّل الدالة toInt()
العدد العشري (float) الذي استُدعي معها إلى عدد صحيح (أي من النوع Int
). هذا قد يؤدي إلى تدوير العدد المراد تحويله أو اقتطاع جزءٍ منه.
toLong
تحوّل الدالة toLong()
العدد العشري (float) الذي استُدعي معها إلى عدد من النوع Long
(عدد طويل). هذا قد يؤدي إلى تدوير العدد المراد تحويله أو اقتطاع جزءٍ منه.
toShort
تحوّل الدالة toShort()
العدد العشري (float) الذي استُدعي معها إلى عدد من النوع Short
(عدد قصير). هذا قد يؤدي إلى تدوير العدد المراد تحويله أو اقتطاع جزءٍ منه.
unaryMinus
تعيد الدالةunaryMinus()
القيمة السالبة المقابلة للعدد العشري (float) الذي استُدعي معها.
unaryPlus
تعيد الدالة unaryPlus()
العدد العشري (float) الذي استُدعي معها.
الخاصيات المُصاحبة (Companion Object Properties)
MAX_VALUE
يمثل الثابت Float.MAX_VALUE
أكبر قيمة موجبة نهائية (finite) لعدد عشري (float).
MIN_VALUE
يمثل الثابت Float.MIN_VALUE
أصغر قيمة موجبة غير صفرية يمكن أن يأخذها عدد عشري (float).
NEGATIVE_INFINITY
يمثل الثابت Float.NEGATIVE_INFINITY
قيمة سالبة لا نهائية (infinity) لعدد عشري (float).
يمثل الثابت Float.NaN
قيمة غير عددية (Not a Number) لعدد من النوع Float
.
POSITIVE_INFINITY
يمثل الثابت Float.POSITIVE_INFINITY
قيمة موجبة لا نهائية (infinity) لعدد عشري (float).