الفرق بين المراجعتين ل"Kotlin/Float"

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث
ط (نقل جميل-بيلوني صفحة Kotlin/Float/index إلى Kotlin/Float: هو وجود الكلمة "index" في نهاية الرابط وهذا يخالف ما هو معتمد في بقية صفحات الموسوعة.)
سطر 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>
 
<noinclude>{{DISPLAYTITLE:الصنف <code>‎‎Float</code>‎ في Kotlin}}</noinclude>
 
=== <code>[[Kotlin/Float/compareTo|compareTo]]</code> ===
 
=== <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>[[Kotlin/Float/dec|dec]]</code> ===
−
تخفض الدالة<code>dec()‎</code> قيمة العدد الذي استُدعيت عبره بواحد ثم تعيد القيمة الناتجة.
+
تنقص الدالة <code>dec()‎</code> العدد العشري (float) الذي استُدعي معها بمقدار 1 ثمَّ تعيد القيمة الناتجة.
  
 
=== <code>[[Kotlin/Float/div|div]]</code> ===
 
=== <code>[[Kotlin/Float/div|div]]</code> ===
−
تقوم الدالة<code>div()‎</code> بقسمة العدد الذي استُدعيت عبره على العدد الممرّر.
+
تقسِّم الدالة <code>div()‎</code> <nowiki/>[[Kotlin/Float|العدد العشري]] (float) الذي استُدعي معها على العدد المُمرّر إليها ثمَّ تعيد الناتج.
  
 
=== <code>[[Kotlin/Float/inc|inc]]</code> ===
 
=== <code>[[Kotlin/Float/inc|inc]]</code> ===
−
ترفع الدالة<code>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> بطرح العدد الممرّر من العدد الذي استُدعيت عبره.
+
تطرح الدالة <code>minus()‎</code> العدد الممرّر إليها من <nowiki/>[[Kotlin/Float|العدد العشري]] (float) الذي استُدعي معها ثم تعيد الناتج.
  
 
=== <code>[[Kotlin/Float/plus|plus]]</code> ===
 
=== <code>[[Kotlin/Float/plus|plus]]</code> ===
−
تقوم الدالة<code>plus()‎</code> بإضافة العدد الممرّر إلى العدد الذي استُدعيت عبره.
+
تجمع الدالة <code>plus()‎</code> <nowiki/>[[Kotlin/Float|العدد العشري]] (float) الذي استُدعي معها مع العدد الممرّر إليها ثم تعيد الناتج.
  
 
=== <code>[[Kotlin/Float/rem|rem]]</code> ===
 
=== <code>[[Kotlin/Float/rem|rem]]</code> ===
−
تحسب الدالة<code>rem()‎</code> باقي عملية قسمة العدد الذي استُدعيت عبره على العدد الممرّر إليها.
+
تحسب الدالة <code>rem()‎</code> باقي عملية قسمة <nowiki/>[[Kotlin/Float|العدد العشري]] (double) الذي استُدعي معها على العدد الممرّر إليها.
  
 
=== <code>[[Kotlin/Float/times|times]]</code> ===
 
=== <code>[[Kotlin/Float/times|times]]</code> ===
−
تقوم الدالة<code>times()‎</code> بحساب ضرب العدد الممرّر مع العدد الذي استُدعيت عبره.
+
تضرب الدالة <code>times()‎</code> العدد الممرّر إليها <nowiki/>[[Kotlin/Float|بالعدد العشري]] (float) المستدعى معها ثمَّ تعيد الناتج.
  
 
=== <code>[[Kotlin/Float/toByte|toByte]]</code> ===
 
=== <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>[[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>[[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>[[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>[[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>[[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>[[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>[[Kotlin/Float/unaryMinus|unaryMinus]]</code> ===
−
تعيد الدالة<code>unaryMinus()‎</code> سالب العدد الذي استُدعيت عبره.
+
تعيد الدالة<code>unaryMinus()‎</code> القيمة السالبة المقابلة <nowiki/>[[Kotlin/Float|للعدد العشري]] (float) الذي استُدعي معها.
  
 
=== <code>[[Kotlin/Float/unaryPlus|unaryPlus]]</code> ===
 
=== <code>[[Kotlin/Float/unaryPlus|unaryPlus]]</code> ===
−
تعيد الدالة<code>unaryPlus()‎</code> العدد الذي استُدعيت عبره.
+
تعيد الدالة <code>unaryPlus()‎</code> <nowiki/>[[Kotlin/Float|العدد العشري]] (float) الذي استُدعي معها.
  
 
== الخاصيات المُصاحبة (Companion Object Properties) ==
 
== الخاصيات المُصاحبة (Companion Object Properties) ==
  
 
=== <code>[[Kotlin/Float/MAX_VALUE|MAX_VALUE]]</code> ===
 
=== <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>[[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>[[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>[[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]]
−
[[تصنيف:Kotlin Classes]]
+
[[تصنيف:Kotlin Class]]
 
[[تصنيف:Kotlin Float]]
 
[[تصنيف: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

 مصادر

مجلوبة من "https://wiki.hsoub.com/index.php?title=Kotlin/Float&oldid=17535"