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

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

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

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

ceil([ndigits])  →  integer or float‎

المعاملات

`ndigits‎`

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

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

يعاد عدد صحيح أو عشري أصغر عدد من الأعداد الأكبر من أو تساوي العدد المعطى وبدقة ndigits للمنازل العشرية فيه.

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

أمثلة

مثال على استعمال التابع ceil:

1.2.ceil      #=> 2
2.0.ceil      #=> 2
(-1.2).ceil   #=> -1
(-2.0).ceil   #=> -2

1.234567.ceil(2)   #=> 1.24
1.234567.ceil(3)   #=> 1.235
1.234567.ceil(4)   #=> 1.2346
1.234567.ceil(5)   #=> 1.23457

34567.89.ceil(-5)  #=> 100000
34567.89.ceil(-4)  #=> 40000
34567.89.ceil(-3)  #=> 35000
34567.89.ceil(-2)  #=> 34600
34567.89.ceil(-1)  #=> 34570
34567.89.ceil(0)   #=> 34568
34567.89.ceil(1)   #=> 34567.9
34567.89.ceil(2)   #=> 34567.89
34567.89.ceil(3)   #=> 34567.89

يُلاحظ أن الدقة المحدودة للمنازل العشرية الحسابية (floating point arithmetic) قد تؤدي إلى نتائج مُدهشة:

(2.1 / 0.7).ceil  #=> 4 (!)

انظر أيضا

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

مصادر

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

@@ سطر 3: / سطر 3: @@
 [[تصنيف: Ruby Method]]
 [[تصنيف: Ruby Float]]
-يعيد التابع <code>ceil</code> أصغر عدد من الأعداد الأكبر من أو تساوي العدد الذي استُدعي معه وبدقة محدَّدة.
+يعيد التابع <code>ceil</code> أصغر عدد من الأعداد الأكبر من أو تساوي العدد العشري الذي استُدعي معه وبدقة محدَّدة.
-ينفِّذ الصنف <code>Numeric</code> هذه العملية عن طريق تحويل قيمة العدد المعطى إلى النوع <code>[[Ruby/Float|Float]]</code> ثم استدعاء التابع <code>[[Ruby/Float/ceil|Float.ceil]]</code>.
 ==البنية العامة==
 <syntaxhighlight lang="ruby">ceil([ndigits])  →  integer or float‎</syntaxhighlight>
@@ سطر 11: / سطر 9: @@
 ===<code>ndigits‎</code>===
-عدد يمثل دقة المنازل العشري. القيمة الافتراضية هي: 0.
+عدد يمثل دقة المنازل العشري. القيمة الافتراضية هي: 0. عندما تكون الدقة <code>ndigits‎</code> المعطاة قيمة موجبة، يعاد عدد عشري، وإلا يُعاد عددٌ صحيحٌ. وأما عندما تكون الدقة <code>ndigits‎</code> سالبة، تكون القيمة المُعادة عدد صحيح متبوعًا بعدد أصفار مقداره <code>ndigits.abs</code> على الأقل.
 ==القيمة المعادة==
 يعاد عدد [[Ruby/Integer|صحيح]] أو [[Ruby/Float|عشري]] أصغر عدد من الأعداد الأكبر من أو تساوي العدد المعطى وبدقة <code>ndigits</code> للمنازل العشرية فيه.
+عندما تكون الدقة <code>ndigits</code> المعطاة قيمة موجبة، يعاد عدد عشري، وإلا يُعاد عددٌ صحيحٌ. وأما عندما تكون الدقة سالبة، تكون القيمة المُعادة عدد صحيح متبوعًا بعدد أصفار مقداره <code>ndigits.abs</code> على الأقل. المعطاة قيمة موجبة، يعاد عدد عشري، وإلا يُعاد عددٌ صحيحٌ. وأما عندما تكون الدقة سالبة، تكون القيمة المُعادة عدد صحيح متبوعًا بعدد أصفار مقداره <code>ndigits.abs</code> على الأقل.
+== أمثلة ==
+مثال على استعمال التابع <code>ceil</code>:<syntaxhighlight lang="ruby">
+.2.ceil      #=> 2
+.0.ceil      #=> 2
+(-1.2).ceil   #=> -1
+(-2.0).ceil   #=> -2
+.234567.ceil(2)   #=> 1.24
+.234567.ceil(3)   #=> 1.235
+.234567.ceil(4)   #=> 1.2346
+.234567.ceil(5)   #=> 1.23457
+.89.ceil(-5)  #=> 100000
+.89.ceil(-4)  #=> 40000
+.89.ceil(-3)  #=> 35000
+.89.ceil(-2)  #=> 34600
+.89.ceil(-1)  #=> 34570
+.89.ceil(0)   #=> 34568
+.89.ceil(1)   #=> 34567.9
+.89.ceil(2)   #=> 34567.89
+.89.ceil(3)   #=> 34567.89
+</syntaxhighlight>يُلاحظ أن الدقة المحدودة للمنازل العشرية الحسابية (floating point arithmetic) قد تؤدي إلى نتائج مُدهشة:<syntaxhighlight lang="ruby">
+(2.1 / 0.7).ceil  #=> 4 (!)
+</syntaxhighlight>
 ==انظر أيضا==
-* التابع <code>[[Ruby/Float/floor|floor]]</code>: أكبر عدد من الأعداد الأصغر من أو تساوي العدد الذي استُدعي معه وبدقة محدَّدة.
+* التابع <code>[[Ruby/Float/floor|floor]]</code>: أكبر عدد من الأعداد الأصغر من أو تساوي العدد العشري الذي استُدعي معه وبدقة محدَّدة.
 ==مصادر==
-*[http://ruby-doc.org/core-2.5.1/Numeric.html#method-i-ceil قسم التابع ceil‎ في الصنف Float في توثيق روبي الرسمي.]
+*[http://ruby-doc.org/core-2.5.1/Float.html#method-i-ceil قسم التابع ceil‎ في الصنف Float في توثيق روبي الرسمي.]