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

مراجعة 12:07، 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).

NaN

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

`POSITIVE_INFINITY`

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

الخاصيات الإضافية (Extension Properties)

`absoluteValue`

`sign`

`ulp`

الدوال الإضافية (Extension Functions)

`IEEErem`

`coerceAtLeast`

`coerceAtMost`

`coerceIn`

`isFinite`

`isInfinite`

`isNaN`

`nextDown`

`nextTowards`

`nextUp`

`pow`

`rangeTo`

`roundToInt`

`roundToLong`

`toBigDecimal`

`toBits`

`toRawBits`

`withSign`

الدوال الإضافية المصاحبة (Companion Object Extension Functions)

`fromBits`

مصادر

صفحة الصنف Float في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.

@@ سطر 1: / سطر 1: @@
+يمثل الصنف <code>Float</code> عددًا عشريًّا (دقة أحادية للأعداد بعد الفاصلة [single-precision floating point]) بحجم 32 بت مطابقًا للمعيار 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>compareTo()‎</code> بين قيمة العنصر الذي استُدعيت عبره والقيمة المُمرّرة، إذ تعيد القيمة <code>0</code> إن كانا متساويين، أو تعيد قيمة سلبية إن كانت قيمة العنصر الذي استُدعيت عبره أصغر من القيمة المُمرّرة، أو تعيد قيمة موجبة إن كانت قيمة العنصر الذي استُدعيت عبره أكبر من القيمة المُمرّرة .
+توازن الدالة <code>compareTo()‎</code> بين <nowiki/>[[Kotlin/Float|عدد عشري]] (float) وعدد آخر ثمَّ تعيد القيمة 0 إن كانا متساويين، أو قيمة سالبة إن كان العدد الأول (العدد الذي استُدعي مع الدالة) أصغر من العدد الثاني الممرر إليها، أو قيمة موجبة إن كان العدد الأول أكبر من العدد الثاني.
 === <code>[[Kotlin/Float/dec|dec]]</code> ===
-تخفض الدالة<code>dec()‎</code> قيمة العدد الذي استُدعيت عبره بواحد ثم تعيد القيمة الناتجة.
+تنقص الدالة <code>dec()‎</code> العدد العشري (float) الذي استُدعي معها بمقدار 1 ثمَّ تعيد القيمة الناتجة.
 === <code>[[Kotlin/Float/div|div]]</code> ===
-تقوم الدالة<code>div()‎</code> بقسمة العدد الذي استُدعيت عبره على العدد الممرّر.
+تقسِّم الدالة <code>div()‎</code> <nowiki/>[[Kotlin/Float|العدد العشري]] (float) الذي استُدعي معها على العدد المُمرّر إليها ثمَّ تعيد الناتج.
 === <code>[[Kotlin/Float/inc|inc]]</code> ===
-ترفع الدالة<code>inc()‎</code> قيمة العدد الذي استُدعيت عبره بواحد ثم تعيد القيمة الناتجة.
+تزيد الدالة <code>inc()‎</code> <nowiki/>[[Kotlin/Float|العدد العشري]] (float) الذي استُدعي معها بمقدار 1 ثمَّ تعيد القيمة الناتجة.
 === <code>[[Kotlin/Float/minus|minus]]</code> ===
-تقوم الدالة<code>minus()‎</code> بطرح العدد الممرّر من العدد الذي استُدعيت عبره.
+تطرح الدالة <code>minus()‎</code> العدد الممرّر إليها من <nowiki/>[[Kotlin/Float|العدد العشري]] (float) الذي استُدعي معها ثم تعيد الناتج.
 === <code>[[Kotlin/Float/plus|plus]]</code> ===
-تقوم الدالة<code>plus()‎</code> بإضافة العدد الممرّر إلى العدد الذي استُدعيت عبره.
+تجمع الدالة <code>plus()‎</code> <nowiki/>[[Kotlin/Float|العدد العشري]] (float) الذي استُدعي معها مع العدد الممرّر إليها ثم تعيد الناتج.
 === <code>[[Kotlin/Float/rem|rem]]</code> ===
-تحسب الدالة<code>rem()‎</code> باقي عملية قسمة العدد الذي استُدعيت عبره على العدد الممرّر إليها.
+تحسب الدالة <code>rem()‎</code> باقي عملية قسمة <nowiki/>[[Kotlin/Float|العدد العشري]] (double) الذي استُدعي معها على العدد الممرّر إليها.
 === <code>[[Kotlin/Float/times|times]]</code> ===
-تقوم الدالة<code>times()‎</code> بحساب ضرب العدد الممرّر مع العدد الذي استُدعيت عبره.
+تضرب الدالة <code>times()‎</code> العدد الممرّر إليها <nowiki/>[[Kotlin/Float|بالعدد العشري]] (float) المستدعى معها ثمَّ تعيد الناتج.
 === <code>[[Kotlin/Float/toByte|toByte]]</code> ===
-تحوّل الدالة<code>toByte()‎</code> قيمة العنصر الذي استُدعيت عبره إلى عدد من النوع <code>[[Kotlin/Byte/index|Byte]]</code>، والذي قد يعني أنه سيحسب بشكل تقريبي.
+تحوّل الدالة <code>toByte()‎</code> <nowiki/>[[Kotlin/Float|العدد العشري]] (float) الذي استُدعي معها إلى عدد من النوع <code>[[Kotlin/Byte|Byte]]</code>. هذا قد يؤدي إلى تدوير العدد المراد تحويله أو اقتطاع جزءٍ منه.
 === <code>[[Kotlin/Float/toChar|toChar]]</code> ===
-تعيد الدالة<code>toChar()‎</code> الحرف المقابل للقيمة العددية للعنصر الذي استُدعيت عبره، مُقتطعة (truncated) إلى 16 بتة إن كان ضروريًا.
+تحول الدالة <code>toChar()‎</code> <nowiki/>[[Kotlin/Float|العدد العشري]] (float) الذي استُدعي معها إلى المحرف الذي يقابله (أي من النوع <code>[[Kotlin/Char|Char]]</code>) بعد اقتطاعه إلى 16 بت إن تطلب ذلك.
 === <code>[[Kotlin/Float/toDouble|toDouble]]</code> ===
-تحول الدالة<code>toDouble()‎</code> قيمة العنصر الذي استُدعيت عبره إلى عدد من النوع <code>[[Kotlin/Double/index|Double]]</code>، والذي قد يعني أنه سيحسب بشكل تقريبي.
+تحوّل الدالة <code>toDouble()‎</code> <nowiki/>[[Kotlin/Float|العدد العشري]] الذي استُدعي معها إلى عدد عشري مضاعف (أي من النوع <code>[[Kotlin/Double|Double]]</code>). هذا قد يؤدي إلى تدوير العدد المراد تحويله.
 === <code>[[Kotlin/Float/toFloat|toFloat]]</code> ===
-تحول الدالة<code>toFloat()‎</code> قيمة العنصر الذي استُدعيت عبره إلى عدد من النوع <code>[[Kotlin/Float/index|Float]]</code>، والذي قد يعني أنه سيحسب بشكل تقريبي.
+تحوّل الدالة <code>toFloat()‎</code> العدد الذي استُدعي معها إلى عدد عشري (أي من النوع <code>[[Kotlin/Float|Float]]</code>). هذا قد يؤدي إلى تدوير العدد المراد تحويله.
 === <code>[[Kotlin/Float/toInt|toInt]]</code> ===
-تحول الدالة<code>toInt()‎</code> قيمة العنصر الذي استُدعيت عبره إلى عدد من النوع <code>int</code>، والذي قد يعني أنه سيحسب بشكل تقريبي.
+تحوّل الدالة <code>toInt()‎</code> <nowiki/>[[Kotlin/Float|العدد العشري]] (float) الذي استُدعي معها إلى عدد صحيح (أي من النوع <code>Int</code>). هذا قد يؤدي إلى تدوير العدد المراد تحويله أو اقتطاع جزءٍ منه.
 === <code>[[Kotlin/Float/toLong|toLong]]</code> ===
-تحول الدالة<code>toLong()‎</code> قيمة العنصر الذي استُدعيت عبره إلى عدد من النوع <code>Long</code>، والذي قد يعني أنه سيحسب بشكل تقريبي.
+تحوّل الدالة <code>toLong()‎</code> <nowiki/>[[Kotlin/Float|العدد العشري]] (float) الذي استُدعي معها إلى عدد من النوع <code>Long</code> (عدد طويل). هذا قد يؤدي إلى تدوير العدد المراد تحويله أو اقتطاع جزءٍ منه.
 === <code>[[Kotlin/Float/toShort|toShort]]</code> ===
-تحول الدالة<code>toShort()‎</code> قيمة العنصر الذي استُدعيت عبره إلى عدد من النوع <code>Short</code>، والذي قد يعني أنه سيحسب بشكل تقريبي.
+تحوّل الدالة <code>toShort()‎</code> <nowiki/>[[Kotlin/Float|العدد العشري]] (float) الذي استُدعي معها إلى عدد من النوع <code>Short</code> (عدد قصير). هذا قد يؤدي إلى تدوير العدد المراد تحويله أو اقتطاع جزءٍ منه.
 === <code>[[Kotlin/Float/unaryMinus|unaryMinus]]</code> ===
-تعيد الدالة<code>unaryMinus()‎</code> سالب العدد الذي استُدعيت عبره.
+تعيد الدالة<code>unaryMinus()‎</code> القيمة السالبة المقابلة <nowiki/>[[Kotlin/Float|للعدد العشري]] (float) الذي استُدعي معها.
 === <code>[[Kotlin/Float/unaryPlus|unaryPlus]]</code> ===
-تعيد الدالة<code>unaryPlus()‎</code> العدد الذي استُدعيت عبره.
+تعيد الدالة <code>unaryPlus()‎</code> <nowiki/>[[Kotlin/Float|العدد العشري]] (float) الذي استُدعي معها.
 == الخاصيات المُصاحبة (Companion Object Properties) ==
 === <code>[[Kotlin/Float/MAX_VALUE|MAX_VALUE]]</code> ===
-<code>MAX_VALUE</code> هي ثابتة تحتوي القيمة القصوى للنوع <code>[[Kotlin/Float/index|Float]]</code>.
+يمثل الثابت <code>Float.MAX_VALUE</code> أكبر قيمة موجبة نهائية (finite) <nowiki/>[[Kotlin/Float|لعدد عشري]] (float).
 === <code>[[Kotlin/Float/MIN_VALUE|MIN_VALUE]]</code> ===
-<code>MIN_VALUE</code> هي ثابتة تحتوي القيمة الدنيا للنوع <code>[[Kotlin/Float/index|Float]]</code>.
+يمثل الثابت <code>Float.MIN_VALUE</code> أصغر قيمة موجبة غير صفرية يمكن أن يأخذها <nowiki/>[[Kotlin/Float|عدد عشري]] (float).
 === <code>[[Kotlin/Float/NEGATIVE_INFINITY|NEGATIVE_INFINITY]]</code> ===
-<code>NEGATIVE_INFINITY</code> هي ثابتة تحتوي قيمة اللانهاية السالبة للنوع <code>[[Kotlin/Float/index|Float]]</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>POSITIVE_INFINITY</code> هي ثابتة تحتوي قيمة اللانهاية الموجبة للنوع <code>[[Kotlin/Float/index|Float]]</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 Classes]]
+[[تصنيف:Kotlin Class]]
 [[تصنيف:Kotlin Float]]