الفرق بين المراجعتين لصفحة: «Ruby/Float/truncate»

المراجعة الحالية بتاريخ 09:19، 24 نوفمبر 2018

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

البنية العامة

truncate([ndigits])  →  integer or float‎

المعاملات

`ndigits‎`

عدد يحدد الدقة. إذا كانت الدقة سالبة، فإنّ القيمة المعادة ستكون عددًا صحيحًا مع ndigits.abs صفر إضافي على الأقل. في حال كانت قيمة ndigits‎ منعدمة أو موجبة، فسيعيد التابع truncate‎ العدد الذي استُدعي معه. القيمة الافتراضية هي: 0.

القيمة المعادة

يعيد التابع truncate‎ العدد الذي استُدعي معه مُقتطعًا وفق دقة (precision) تساوي ndigits رقم عشري. إذا كانت الدقة سالبة، فإنّ القيمة المعادة ستكون عددًا صحيحًا مع ndigits.abs صفر إضافي على الأقل. في حال كانت قيمة ndigits‎ منعدمة أو موجبة، فسيعيد التابع truncate‎ العدد الذي استُدعي معه.

أمثلة

مثال على استعمال التابع truncate‎:

2.8.truncate           #=> 2
(-2.8).truncate        #=> -2
1.234567.truncate(2)   #=> 1.23
34567.89.truncate(-2)  #=> 34500

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

(0.3 / 0.1).truncate  #=> 2 (!)

انظر أيضا

التابع round: يقرِّب العدد العشري الذي استُدعي معه إلى أقرب قيمة مع دقة (precision) تساوي العدد الممرر إليه.
التابع ceil: يعيد أصغر عدد من الأعداد الأكبر من أو تساوي قيمة العدد العشري الذي استُدعي معه.

مصادر

قسم التابع truncate‎ في الصنف Float في توثيق روبي الرسمي.

@@ سطر 3: / سطر 3: @@
 [[تصنيف: Ruby Method]]
 [[تصنيف: Ruby Float]]
-يعيد التابع <code>truncate‎</code> العدد الذي استُدعي معه بعد اقتطاعه إلى دقة (precision) محدَّدة.
+يعيد التابع <code>truncate‎</code> العدد العشري الذي استُدعي معه بعد اقتطاعه إلى دقة (precision) محدَّدة.
 ==البنية العامة==
 <syntaxhighlight lang="ruby">truncate([ndigits])  →  integer or float‎</syntaxhighlight>
@@ سطر 12: / سطر 12: @@
 ==القيمة المعادة==
 يعيد التابع <code>truncate‎</code> العدد الذي استُدعي معه مُقتطعًا وفق دقة (precision) تساوي <code>ndigits</code> رقم عشري. إذا كانت الدقة سالبة، فإنّ القيمة المعادة ستكون عددًا صحيحًا مع <code>ndigits.abs</code> صفر إضافي على الأقل. في حال كانت قيمة <code>ndigits‎</code> منعدمة أو موجبة، فسيعيد التابع <code>truncate‎</code> العدد الذي استُدعي معه.
-==أمثلة==
-مثال على استخدام التابع <code>truncate‎</code>:
+== أمثلة ==
-<syntaxhighlight lang="ruby">1.truncate           #=> 1
+مثال على استعمال التابع <code>truncate‎</code>:<syntaxhighlight lang="ruby">
-.truncate(2)        #=> 1
+.8.truncate           #=> 2
-.truncate(-1)      #=> 10
+(-2.8).truncate        #=> -2
-(-18).truncate(-1)   #=> -10
+.234567.truncate(2)   #=> 1.23
-‎</syntaxhighlight>
+.89.truncate(-2)  #=> 34500
+</syntaxhighlight>يُلاحظ أن الدقة المحدودة للعمليات الحسابية التي تُجرَى على الأعداد العشرية قد تؤدي إلى نتائج مُدهشة. إليك المثال التالي:<syntaxhighlight lang="ruby">
+(0.3 / 0.1).truncate  #=> 2 (!)
+</syntaxhighlight>
 ==انظر أيضا==
-* التابع <code>[[Ruby/Float/round|round]]</code>: يقرِّب العدد الذي استُدعي معه إلى أقرب قيمة مع دقة (precision) تساوي العدد الممرر إليه.
+* التابع <code>[[Ruby/Float/round|round]]</code>: يقرِّب العدد العشري الذي استُدعي معه إلى أقرب قيمة مع دقة (precision) تساوي العدد الممرر إليه.
-* التابع <code>[[Ruby/Float/ceil|ceil]]</code>: يعيد أصغر عدد من الأعداد الأكبر من أو تساوي قيمة العدد الذي استُدعي معه.
+* التابع <code>[[Ruby/Float/ceil|ceil]]</code>: يعيد أصغر عدد من الأعداد الأكبر من أو تساوي قيمة العدد العشري الذي استُدعي معه.
 ==مصادر==
-*[http://ruby-doc.org/core-2.5.1/Integer.html#method-i-truncate قسم التابع truncate‎ في الصنف Float في توثيق روبي الرسمي.]
+*[http://ruby-doc.org/core-2.5.1/Float.html#method-i-truncate قسم التابع truncate‎ في الصنف Float في توثيق روبي الرسمي.]