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

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

مصادر

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