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

المراجعة الحالية بتاريخ 08:19، 9 سبتمبر 2018

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

class Double : Number, Comparable<Double>

الدوال

`compareTo`

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

`dec`

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

`div`

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

`inc`

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

`minus`

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

`plus`

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

`rem`

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

`times`

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

`toByte`

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

`toChar`

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

`toDouble`

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

`toFloat`

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

`toInt`

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

`toLong`

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

`toShort`

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

`unaryMinus`

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

`unaryPlus`

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

الخاصيات المصاحبة (Companion Object Properties)

`MAX_VALUE`

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

`MIN_VALUE`

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

`NEGATIVE_INFINITY`

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

NaN

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

`POSITIVE_INFINITY`

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

الخاصيات الإضافية (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`

مصادر

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

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