الصنف Float في روبي

من موسوعة حسوب
اذهب إلى: تصفح، ابحث

تمثِّل كائنات الصنف Float أعدادًا حقيقيةً غير دقيقة (inexact real numbers) باستخدام التمثيل العشري ذي الدقة المضاعفة للبنية الأصلية.

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

الثوابت

DIG

الحد الأدنى لعدد الأرقام العشرية ذات الدلالة في المنازل العشرية المزدوجة الدقة. وعادةً ما تكون قيمته الافتراضية 15.

EPSILON

الفرق بين 1 و أصغر عدد عشري ذي دقة مضاعفة أكبر من 1 من نوع النقطة العائمة المزدوجة الدقة. وعادة ما تكون قيمته الافتراضية هي 2.2204460492503131e-16.

INFINITY

يمثل اللانهاية الموجبة.

MANT_DIG

عدد الأرقام الأساسية للأعداد العشرية المضاعفة (أي البيانات ذات النوع double). وعادةً ما تكون قيمته الافتراضية هي 53.

MAX

أكبر عدد صحيح في العدد العشري ذي الدقة المضاعفة. وعادةً ما تكون قيمته الافتراضية 1.7976931348623157e+308.

MAX_10_EXP

أكبر أس موجب في العدد العشري ذي الدقة المضاعفة حيث تكون القيمة 10 مرفوعة إلى هذا الأس بعد طرح القيمة 1 منها. وعادةً ما تكون قيمته الافتراضية هي 308.

MAX_EXP

أكبر قيمة أس محتملة في العدد العشري ذي الدقة المضاعفة. وعادةً ما تكون قيمته الافتراضية هي 1024.

MIN

أصغر رقم طبيعي (normalized number) موجب في العدد العشري ذي الدقة المضاعفة. وعادة ما تكون قيمته الافتراضية 2.2250738585072014e-308.

إذا كانت المنصة تدعم الأعداد غير الطبيعية (denormalized numbers)، فسيكون هناك أرقام بين الصفر والقيمة Float::MIN. وتعيد ‎0.0.next_float أصغر عدد عشري موجب بما في ذلك الأعداد غير الطبيعية (denormalized numbers).

MIN_10_EXP

أصغر أس سالب في العدد العشري ذي الدقة المضاعفة إذ تكون 10 مرفوعة إلى هذا الأس ناقص 1. وعادةً ما تكون قيمته الافتراضية ‎-307.

MIN_EXP

أصغر قيمة أس محتملة في العدد العشري ذي الدقة المضاعفة. وعادةً ما تكون قيمته الافتراضية ‎-1021.

NAN

تعبير يمثل القيمة "ليست عددًا" (not a number).

RADIX

أساس العدد العشري، أو عدد الأرقام الفريدة المستخدمة لتمثيل العدد. وعادةً ما تكون قيمته الافتراضية 2 على معظم الأنظمة، والتي تمثل النظام العشري ذي الأساس 10.

ROUNDS

يمثل وضع التقريب لإضافة المنازل العشرية. وعادةً ما تكون قيمته الافتراضية 1، التقريب إلى أقرب عدد.

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

  • -1: مُتعذِّر تحديده.
  • 0: التقريب نحو الصفر.
  • 1: التقريب إلى أقرب عدد.
  • 2: التقريب نحو اللانهاية الموجبة.
  • 3: التقريب نحو اللانهاية السالبة.

توابع النسخة العامة

%

يعيد باقي عملية قسمة عدد عشري على عدد آخر.

*

يعيد ناتج عملية ضرب عدد عشري بعدد آخر.

**

يعيد ناتج عملية رفع عدد عشري (الأساس) إلى قوة عدد محدد (الأس).

+

يعيد ناتج عملية الجمع بين عددين.

-

يعيد ناتج عملية الطرح بين عددين.

-

إن استُعمِل هذا المعامل بالشكل ‎-Float، فسيعيد القيمة المعاكسة للعدد Float العشري (أي القيمة السالبة إن كان Float موجبًا أو العكس بالعكس).

/

يعيد ناتج عملية القسمة بين عدد عشري وعدد آخر.

>

يعيد القيمة true إن كانت قيمة العدد العشري الواقع على يساره أصغر من قيمة العدد المواقع على يمينه.

=>

يعيد القيمة true إن كانت قيمة العدد العشري الواقع على يساره أصغر من أو تساوي قيمة العدد الواقع على يمينه.

<=>

يعيد عددً‎ا صحيحًا (‎-1 أو 0 أو ‎+1) إذا كان العدد العشري الواقع على يساره أصغر من أو يساوي أو أكبر من العدد الآخر الواقع على يمينه على التوالي.

==

يعيد القيمة true إن كان العدد العشري الواقع على يساره يساوي القيمة الواقعة على يمينه. 

<

يعيد القيمة true إن كانت قيمة العدد العشري الواقع على يساره أكبر من قيمة العدد الآخر الواقع على يمينه.

=<

يعيد القيمة true إن كانت قيمة العدد العشري الواقع على يساره أكبر من أو تساوي قيمة العدد الآخر الواقع على يمينه.

abs

يعيد القيمة المطلقة للعدد العشري الذي استُدعي معه.

angle

يعيد القيمة 0 إن كان العدد العشري الذي استُدعي معه موجبًا، أو القيمة pi خلاف ذلك.

arg

يعيد القيمة 0 إن كان العدد العشري الذي استُدعي معه موجبًا، أو القيمة pi خلاف ذلك.

ceil

يعيد أصغر عدد من الأعداد الأكبر من أو تساوي العدد العشري الذي استُدعي معه وبدقة محدَّدة.

coerce

يحول العدد المستدعى معها والعدد العشري المُمرَّر إليها إلى النوع Float ويعيدهما في مصفوفة.

denominator

يعيد المقام (denominator) للعدد الكسري الذي استدعي معه، ويكون دائمًا موجبًا.

divmod

يعيد مصفوفة تحتوي على حاصل (quotient) وباقي قسمة العدد الذي استُدعي معه على العدد المُمرَّر إليه.

eql?‎

يتحقق إن كان العدد الذي استُدعي معه والعدد المُمرَّر إليه من نفس النوع (أي كلاهما عدد عشري) ومتساويين في القيمة.

fdiv

يجري عملية القسمة بين العدد الذي استدعي معه والعدد الذي مُرِّر إليه ثم يعيد الناتج في عدد عشري.

finite?‎

يتحقق إذا كان العدد العشري الذي استدعي معه عددًا عشريًّا صالحًا وفقًا لمعيار IEEE؛ أي أنه ليس عددٌ لا نهائي ويعيد التابع ‎nan?‎ القيمة false معه.

floor

يعيد أكبر عدد من الأعداد الأصغر من أو تساوي العدد العشري الذي استُدعي معه وبدقة محدَّدة.

hash

يعيد القيمة hash للعدد العشري الذي استدعي معه.

infinite?‎

يتحقق إذا ما إن كان العدد الذي استدعي معه منتهيًا (finite) أو غير منتهي من الطرف السالب (‎-Infinity) أو غير منتهي من الطرف الموجب (‎+Infinity).

inspect

هو اسم بديل للتابع to_s.

magnitude

يعيد القيمة المطلقة للعدد العشري الذي استُدعي معه.

modulo

يعيد باقي عملية قسمة العدد العشري الذي استُدعي معه على العدد المُعطى.

nan?‎

يتحقق إذا كان العدد العشري الذي استدعي معه عددًا عشريًّا غير صالح وفقًا لمعيار IEEE.

negative?‎

يتحقق إن كان العدد العشري الذي استُدعي معه عددًا سالبًا.

next_float

يعيد العدد العشري الذي يلي العدد العشري الذي استُدعي معه.

numerator

يعيد البسط للعد الكسري الذي استدعي معه.

phase

يعيد القيمة 0 إن كان العدد العشري الذي استُدعي معه موجبًا، أو يعيد القيمة piخلاف ذلك.

positive?‎

يتحقق إن كان العدد العشري الذي استُدعي معه عددًا موجبًا.

prev_float

يعيد العدد العشري الذي يسبق العدد العشري الذي استُدعي معه.

quo

يعيد ناتج قسم العدد العشري المستدعى معه على العدد العشري المُمرَّر إليه.

rationalize

يعيد قيمة تقريبة بسيطة (flt-|eps| <= result <= flt+|eps|‎) للعدد العشري الذي استدعي معه.

round

يقرِّب العدد الذي استُدعي معه إلى أقرب قيمة بدقة محدَّدة.

to_f

يعيد العدد العشري الذي استدعي معه نفسه.

to_i

يحول العدد العشري الذي استُدعي معه إلى عدد صحيح.

to_int

يحول العدد العشري الذي استُدعي معه إلى عدد صحيح.

to_r

يحول العدد العشري الذي استُدعي معه إلى عدد جذري (rational).

to_s

يحول العدد العشري الذي استدعي معه إلى سلسلة نصية.

truncate

يعيد العدد العشري الذي استُدعي معه بعد اقتطاعه إلى دقة (precision) محدَّدة.

zero?‎

يتحقق إن كانت قيمة العدد العشري الذي استُدعي معه تساوي الصفر.

مصادر