عرض مصدر Ruby/Float/ceil

<noinclude>{{DISPLAYTITLE: التابع <code>Float.ceil‎</code> في روبي}}</noinclude>
[[تصنيف: Ruby]]
[[تصنيف: Ruby Method]]
[[تصنيف: Ruby Float]]
يعيد التابع <code>ceil</code> أصغر عدد من الأعداد الأكبر من أو تساوي العدد العشري الذي استُدعي معه وبدقة محدَّدة.
==البنية العامة==
<syntaxhighlight lang="ruby">ceil([ndigits])  →  integer or float‎</syntaxhighlight>
==المعاملات==
===<code>ndigits‎</code>===

عدد يمثل دقة المنازل العشري. القيمة الافتراضية هي: 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">
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
</syntaxhighlight>يُلاحظ أن الدقة المحدودة للمنازل العشرية الحسابية (floating point arithmetic) قد تؤدي إلى نتائج مُدهشة:<syntaxhighlight lang="ruby">
(2.1 / 0.7).ceil  #=> 4 (!)
</syntaxhighlight>

==انظر أيضا==
* التابع <code>[[Ruby/Float/floor|floor]]</code>: أكبر عدد من الأعداد الأصغر من أو تساوي العدد العشري الذي استُدعي معه وبدقة محدَّدة.

==مصادر==
*[http://ruby-doc.org/core-2.5.1/Float.html#method-i-ceil قسم التابع ceil‎ في الصنف Float في توثيق روبي الرسمي.]