عرض مصدر Ruby/Float

<noinclude>{{DISPLAYTITLE: الأعداد العشرية Float في روبي}}</noinclude>
تمثل كائنات Float أرقامًا حقيقية غير دقيقة باستخدام تمثيل النقطة العائمة المزدوجة الدقة للبنية الأصلية.

للنقطة العائمة حساب مختلف وهو رقم غير دقيق. لذا يجب معرفة نظامها الخاص. انظر التالي:

[[docs.sun.com/source/806-3568/ncg_goldberg.html]]

[[wiki.github.com/rdp/ruby_tutorials_core/ruby-talk-faq#wiki-floats_imprecise]]

[[en.wikipedia.org/wiki/Floating_point#Accuracy_problems]]

=== الثوابت ===

==== <code>DIG</code> ====
الحد الأدنى لعدد الأرقام العشرية ذات الدلالة في النقطة العائمة المزدوجة الدقة.

وعادة ما تكون قيمته الافتراضية <code>15</code>.

==== <code>EPSILON</code> ====
الفرق بين <code>1</code> و أصغر عدد أكبر من <code>1</code> من نوع النقطة العائمة المزدوجة الدقة.

وعادة ما تكون قيمته الافتراضية <code>2.2204460492503131e-16</code>.

==== <code>INFINITY</code> ====
تعبير يمثل اللانهاية الموجبة.

==== <code>MANT_DIG</code> ====
عدد الأرقام الأساسية لنوع البيانات المزدوج (double).

وعادة ما تكون قيمته الافتراضية <code>53</code>.

==== <code>MAX</code> ====
أكبر عدد صحيح في النقطة العائمة المزدوجة الدقة.

وعادة ما تكون قيمته الافتراضية <code>1.7976931348623157e+308</code>.

==== <code>MAX_10_EXP</code> ====
أكبر أس موجب في النقطة العائمة المزدوجة الدقة حيث تكون <code>10</code> مرفوعة إلى هذا الأس ناقص <code>1</code>.

وعادة ما تكون قيمته الافتراضية <code>308</code>.

==== <code>MAX_EXP</code> ====
أكبر قيمة أس محتملة في النقطة العائمة المزدوجة الدقة.

وعادة ما تكون قيمته الافتراضية <code>1024</code>.

==== <code>MIN</code> ====
أصغر رقم مُعيَّر موجب في النقطة العائمة المزدوجة الدقة.

وعادة ما تكون قيمته الافتراضية <code>2.2250738585072014e-308</code>.

إذا كانت المنصة تدعم الأرقام غير المُعيَّرة، يكون هناك أرقام بين صفر و <code>Float::MIN</code>. وتعيد <code>‎0.0.next_float</code> أصغر نقطة عائمة موجبة بما في ذلك الأرقام غير المُعيَّرة.

==== <code>MIN_10_EXP</code> ====
أصغر أس سالب في النقطة العائمة المزدوجة الدقة حيث تكون <code>10</code> مرفوعة إلى هذا الأس ناقص <code>1</code>.

وعادة ما تكون قيمته الافتراضية <code>‎-307</code>.

==== <code>MIN_EXP</code> ====
أصغر قيمة أس محتملة في النقطة العائمة المزدوجة الدقة.

وعادة ما تكون قيمته الافتراضية <code>‎-1021</code>.

==== <code>NAN</code> ====
تعبير يمثل القيمة "ليست عددًا" (not a number).

==== <code>RADIX</code> ====
أساس النقطة العائمة، أو عدد الأرقام الفريدة المستخدمة لتمثيل الرقم.

وعادة ما تكون قيمته الافتراضية <code>2</code> على معظم الأنظمة، والتي تمثل النظام العشري للأساس <code>10</code>.

==== <code>ROUNDS</code> ====
يمثل وضع التقريب لإضافة النقطة العائمة.

وعادة ما تكون قيمته الافتراضية <code>1</code>، التقريب إلى أقرب عدد.

وتشمل الأوضاع الأخرى:

‎<code>-1</code> : مُتعذِّر تحديده.

<code>0</code> : التقريب نحو الصفر.

<code>1</code> : التقريب إلى أقرب عدد.

<code>2</code> : التقريب نحو اللانهاية الموجبة.

<code>3</code> : التقريب نحو اللانهاية السالبة.

=== توابع المثيل العام ===

==== <code>float % other → float</code> ====
إعادة الوحدة بعد قسمة <code>float</code> على <code>other</code>.

==== <code>float * other → float</code> ====
إعادة Float جديد والذي يكون هو نتاج حاصل ضرب float و other.

==== <code>float ** other → float</code> ====
رفع float للأس other

==== <code>float + other → float</code> ====
إعادة Float جديد والذي يكون هو نتاج حاصل جمع float و other.

==== <code>float - other → float</code> ====
إعادة Float جديد والذي يكون هو الفرق بين float و other.

==== <code>‎-float → float</code> ====
إعادة float بعلامة سالبة

==== <code>float / other → float</code> ====
إعادة Float جديد والذي يكون نتاج حاصل قسمة float على other.

==== <code>float < real → true or false</code> ====
إعادة true إذا كان float أقل من real.

نتيجة NaN < NaN غير مُعرَّفة، لذا تُعاد قيمة تعتمد على التنفيذ.

==== <code>float <= real → true or false</code> ====
إعادة true إذا كان float أقل من أو يساوي real.

نتيجة NaN <= NaN غير معرفة، لذا تُعاد قيمة تعتمد على التنفيذ.

==== <code>float <=> real → -1, 0, +1, or nil</code> ====
إعادة ‎-1، 0 أو ‎+1 اعتمادًا على ما إذا كان float أقل من أو يساوي أو أكبر من real. هذا هو أساس الاختبارات في وحدة Comparable.

نتيجة NaN <=> NaN غير مُعرَّفة، لذا تُعاد قيمة تعتمد علي التنفيذ.

إعادة nil إذا كانت القيمتين غير صالحتين للمقارنة.

==== <code>float == obj → true or false</code> ====
إعادة true فقط إذا كانت قيمة obj نفس قيمة float. علي عكس ذلك تحتاج ‎#eql?‎ أن يكون obj من نوع Float.

نتيجة NaN == NaN غير مُعرَّفة، لذا تُعاد قيمة تعتمد علي التنفيذ.

==== <code>float == obj → true or false</code> ====
إعادة true فقط إذا كانت قيمة obj نفس قيمة float. علي عكس ذلك تحتاج ‎#eql?‎ أن يكون obj من نوع Float.

نتيجة NaN == NaN غير مُعرَّفة، لذا تُعاد قيمة تعتمد علي التنفيذ.

==== <code>float > real → true or false</code> ====
إعادة true إذا كان float أكبر من real.

نتيجة NaN > NaN غير مُعرَّفة، لذا تُعاد قيمة تعتمد علي التنفيذ.

==== <code>float >= real → true or false</code> ====
إعادة true إذا كان float أكبر من أو يساوي real.

نتيجة NaN >= NaN غير معرفة، لذا تُعاد قيمة تعتمد على التنفيذ.

==== <code>abs → float</code> ====
إعادة القيمة المطلقة للتابع float.

<nowiki>#</nowiki>magnitude اسم مستعار للتابع ‎#abs.

==== <code>angle → 0 or float</code> ====
إعادة 0 إذا كانت القيمة موجبة، أو "ط (pi)" خلاف ذلك.

==== <code>arg → 0 or float</code> ====
إعادة 0 إذا كانت القيمة موجبة، أو "ط (pi)" خلاف ذلك.

==== <code>ceil([ndigits]) → integer or float</code> ====
إعادة أصغر رقم أكبر من أو يساوي float مع دقة ndigits رقم (القيمة الافتراضية: 0).

عندما تكون الدقة سالبة، تكون القيمة المُعادة عدد صحيح متبوعًا بعدد أصفار مقداره ndigits.abs على الأقل.

إعادة رقم نقطة عائمة عندما يكون ndigits موجبًا، وإلا يُعاد عددٌ صحيحٌ.

يُلاحظ أن الدقة المحدودة للنقطة العائمة الحسابية قد تؤدي إلى نتائج مُدهشة:

==== <code>coerce(numeric) → array</code> ====
إعادة مصفوفة يتمثَّل فيها كلٌ من numeric و float ككائنات Float.

ويتحقق ذلك عن طريق تحويل numeric إلى Float.

==== <code>denominator → integer</code> ====
إعادة المقام (موجب دائمًا). والنتيجة تعتمد على الآلة.

انظر أيضا ‎#numerator.

==== <code>divmod(numeric) → array</code> ====
راجع Numeric#divmod.

==== <code>eql?(obj) → true or false</code> ====
إعادة true فقط إذا كانت obj من النوع Float وله نفس قيمة float. علي النقيض من ذلك مع Float#==‎، الذي يُجري تحويلات على النوع.

نتيجة NaN.eql?(NaN)‎ غير معرفة، لذا تُعاد قيمة تعتمد على التنفيذ.

==== <code>fdiv(numeric) → float</code> ====
إعادة float / numeric، مثل Float#/‎.

==== <code>finite? → true or false</code> ====
إعادة true إذا كان float عدد نقطة عائمة IEEE صالح، أي أنه ليس لا نهائي و ‎#nan?‎ قيمتها false.

==== <code>floor([ndigits]) → integer or float</code> ====
إعادة أكبر رقم أصغر من أو يساوي float مع دقة ndigits رقم عشري (القيمة الافتراضية: 0).

عندما تكون الدقة سالبة، تكون القيمة المُعادة عدد صحيح متبوعًا بعدد أصفار مقداره ndigits.abs على الأقل.

إعادة رقم نقطة عائمة عندما يكون ndigits موجبًا، وإلا يُعاد عددٌ صحيحٌ.

يُلاحظ أن الدقة المحدودة للنقطة العائمة الحسابية قد تؤدي إلى نتائج مُدهشة:

==== <code>hash → integer</code> ====
إعادة رمز التجزئة لهذا الرقم العشري.

راجع أيضًا Object#hash.

==== <code>infinite? → -1, 1, or nil</code> ====
إعادة nil أو ‎-1، أو 1 اعتمادًا علي ما إذا كانت القيمة محدودة، أو ‎-Infinity، أو ‎+Infinity.

==== <code>inspect()‎</code> ====
اسم المستعار لـ to_s

==== <code>magnitude → float</code> ====
إعادة القيمة المطلقة للتابع float.

<nowiki>#</nowiki>magnitude اسم مستعار للتابع ‎#abs.

==== <code>modulo(other) → float</code> ====
إعادة الوحدة بعد قسمة float على other.

==== <code>nan? → true or false</code> ====
إعادة true إذا كان float عدد نقطة عائمة IEEE غير صالح.

==== <code>empty? → true or false</code> ====
إعادة true إذا كان float أقل من 0.

==== <code>next_float → float</code> ====
إعادة عدد النقطة العائمة القابل للتمثيل التالي.

Float::MAX.next_float و Float::INFINITY.next_float هما Float::INFINITY.

Float::NAN.next_float هو Float::NAN.

فعلى سبيل المثال:

==== <code>numerator → integer</code> ====
إعادة البسط. والنتيجة تعتمد على الآلة.

انظر أيضا ‎#denominator.

==== <code>phase → 0 or float</code> ====
إعادة 0 إذا كانت القيمة موجبة، أو "ط (pi)" خلاف ذلك.

==== <code>positive? → true or false</code> ====
إعادة true إذا كان float أكبر من 0.

==== <code>prev_float → float</code> ====
إعادة عدد النقطة العائمة القابل للتمثيل السابق.

‎(-Float::MAX).prev_float و ‎(-Float::INFINITY).prev_float هما ‎-Float::INFINITY.

Float::NAN.prev_float هو Float::NAN.

فعلى سبيل المثال:

==== <code>quo(numeric) → float</code> ====
إعادة float / numeric، مثل Float#/‎.

==== <code>rationalize([eps]) → rational</code> ====
إعادة تقريب ابسط للقيمة (flt-|eps| <= result <= flt+|eps|). إذا لم يتاح الوسيط الاختياري eps، سيُختار تلقائيًا.

انظر أيضا ‎#to_r.

==== <code>round([ndigits] [, half: mode]) → integer or float</code> ====
إعادة float مُقرَّب إلى أقرب قيمة بدقة أرقام عشرية مقدارها ndigits (القيمة الافتراضية: 0).

عندما تكون الدقة سالبة، تكون القيمة المُعادة عدد صحيح متبوعًا بعدد أصفار مقداره ndigits.abs على الأقل.

إعادة رقم نقطة عائمة عندما يكون ndigits موجبًا، وإلا يُعاد عددٌ صحيحٌ.

إذا أُتيح وسيط الكلمة المفتاحية half الاختياري، ستُقرَّب الأرقام التي تقع في المنتصف بين قيمتين مقرَّبتين ممكنتين وفقًا للوضع mode المُحدَّد الكاسر للعلاقة:

‎:up أو nil: تقريب النصف بعيدًا عن الصفر (الوضع الافتراضي).

‎:down: تقريب النصف باتجاه الصفر.

‎:even: تقريب النصف باتجاه أقرب عدد زوجي.

to_f → self

بما أن float هو بالأصل Float، يُعيد self.

to_i → integer

to_int → integer

إعادة float مبتورًا إلى Integer.

يُلاحظ أن الدقة المحدودة للنقطة العائمة الحسابية قد تؤدي إلى نتائج مُدهشة:

to_int هو اسم مستعار لـ to_i.

to_int → integer

إعادة float مبتورًا إلى Integer.

يُلاحظ أن الدقة المحدودة للنقطة العائمة الحسابية قد تؤدي إلى نتائج مُدهشة:

to_int هو اسم مستعار لـ to_i.

to_r → rational

إعادة قيمة نسبية.

ملاحظة: ‎0.3.to_r ليس هي نفسه ‎“0.3”.to_r. وهذا الأخير يعادل ‎"3/10".to_r، ولكن الأول ليس كذلك.

انظر أيضا ‎#rationalize.

==== <code>to_s → string</code> ====
إعادة سلسلة تحتوي على تمثيل self. كما هو حال الشكل الثابت أو الأسي لـ float، قد يُعيد الاستدعاء NaN و Infinity و ‎-Infinity.

ويُعيَّن له أيضًا الاسم المستعار: inspect

==== <code>truncate([ndigits]) → integer or float</code> ====
إعادة float مبتورًا (نحو الصفر) إلى دقة أرقام عشرية ndigits (القيمة الافتراضية: 0).

عندما تكون الدقة سالبة، تكون القيمة المُعادة عدد صحيح متبوعًا بعدد أصفار مقداره ndigits.abs على الأقل.

إعادة رقم نقطة عائمة عندما يكون ndigits موجبًا، وإلا يُعاد عددٌ صحيحٌ.

يُلاحظ أن الدقة المحدودة للنقطة العائمة الحسابية قد تؤدي إلى نتائج مُدهشة:

==== <code>zero? → true or false</code> ====
إعادة true إذا كان float يساوي 0.

= مصادر =
* [http://ruby-doc.org/core-2.5.1/Float.html صفحة Float في توثيق روبي الرسمي.]
[[تصنيف:Ruby]]