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

من موسوعة حسوب
< Ruby‏ | Rational
لا ملخص تعديل
ط مراجعة وتدقيق.
 
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE: التابع <code>truncate‎</code> الخاص بالصنف <code>Rational</code> في روبي}}</noinclude>
<noinclude>{{DISPLAYTITLE: التابع <code>Rational.truncate‎</code> في روبي}}</noinclude>
[[تصنيف: Ruby]]
[[تصنيف: Ruby]]
[[تصنيف: Ruby Method]]
[[تصنيف: Ruby Method]]
[[تصنيف: Ruby Rational]]
[[تصنيف: Ruby Rational]]
يعيد التابع <code>truncate</code> العدد الذي استُدعي معه مُقتطعًا (نحو الصفر) بدقة <code>ndigits</code> (انظر فقرة البنية العامة) منزلًا عشريًا (القيمة الافتراضية هي 0).
يقتطع التابع <code>truncate</code> العدد الجذري الذي استُدعي معه نحو الصفر بدقة محدَّدة للمنازل العشرية.
 
عندما تكون الدقة سالبة، القيمة التي تُعاد ستكون عددًا صحيحًا مع <code>ndigits.abs</code> صفرًا زائدًا على الأقل.
 
يُعيد التابع <code>truncate</code> عددا جذريا عندما يكون الوسيط <code>ndigits</code> موجبًا، وإلا فسيُعيد عددًا صحيحًا.
==البنية العامة==
==البنية العامة==
<syntaxhighlight lang="ruby">truncate([ndigits])  →  integer or rational‎</syntaxhighlight>
<syntaxhighlight lang="ruby">truncate([ndigits])  →  integer or rational‎</syntaxhighlight>
==المعاملات==
==المعاملات==
===<code>ndigits‎</code>===
===<code>ndigits‎</code>===
يحدد عدد المنازل العشرية
يحدد دقة عدد المنازل العشرية بعد الفاصلة. القيمة الافتراضية هي: 0. عندما تكون الدقة موجبة، يعاد عدد جذري وإلا يعاد عدد صحيح. أي عندما تكون الدقة سالبة، ستكون القيمة التي تُعاد عددًا صحيحًا مع <code>ndigits.abs</code> صفرًا زائدًا على الأقل.


==القيمة المُعادة==
==القيمة المعادة==
يعيد التابع <code>truncate</code> العدد الذي استُدعي معه مُقتطعًا بدقة <code>ndigits</code>منزلًا عشريًا، والتي ستكون عددا جذريا عندما يكون الوسيط <code>ndigits</code> موجبًا، أو عددًا صحيحًا خلاف ذلك.
يعاد العدد الجذري المعطى مُقتطعًا بدقة <code>ndigits</code> منزلًا عشريًا. عندما تكون الدقة <code>ndigits</code> موجبة، يعاد عدد جذري وإلا يعاد عدد صحيح. أي عندما تكون الدقة سالبة، ستكون القيمة التي تُعاد عددًا صحيحًا مع <code>ndigits.abs</code> صفرًا زائدًا على الأقل.


==أمثلة==
==أمثلة==
سطر 27: سطر 23:
Rational('-123.456').truncate(+1).to_f  #=> -123.4
Rational('-123.456').truncate(+1).to_f  #=> -123.4
Rational('-123.456').truncate(-1)      #=> -120‎</syntaxhighlight>
Rational('-123.456').truncate(-1)      #=> -120‎</syntaxhighlight>
==انظر أيضا==
==انظر أيضًا==
* التابع <code>[[Ruby/Rational/round|round]]</code>: يعيد التابع <code>round</code> العدد الذي استُدعي معه مُقرّبًا إلى أقرب قيمة مع دقة <code>ndigits</code> منزلًا عشريًا.
* التابع [[Ruby/Rational/ceil|<code>ceil</code>]]: يعيد أصغر عدد من الأعداد الأكبر من أو تساوي العدد الجذري الذي استُدعي معه وفق دقة محدَّدة للمنازل العشرية بعد الفاصلة.
 
* التابع <code>[[Ruby/Rational/round|round]]</code>: يقرِّب العدد الجذري الذي استُدعي معه إلى أقرب قيمة مع دقة محدَّدة للمنازل العشرية.


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

المراجعة الحالية بتاريخ 11:24، 3 ديسمبر 2018

يقتطع التابع truncate العدد الجذري الذي استُدعي معه نحو الصفر بدقة محدَّدة للمنازل العشرية.

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

truncate([ndigits])    integer or rational

المعاملات

ndigits‎

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

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

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

أمثلة

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

Rational(3).truncate      #=> 3
Rational(2, 3).truncate   #=> 0
Rational(-3, 2).truncate  #=> -1
  #    decimal      -  1  2  3 . 4  5  6
  #                   ^  ^  ^  ^   ^  ^
  #   precision      -3 -2 -1  0  +1 +2
Rational('-123.456').truncate(+1).to_f  #=> -123.4
Rational('-123.456').truncate(-1)       #=> -120‎

انظر أيضًا

  • التابع ceil: يعيد أصغر عدد من الأعداد الأكبر من أو تساوي العدد الجذري الذي استُدعي معه وفق دقة محدَّدة للمنازل العشرية بعد الفاصلة.
  • التابع round: يقرِّب العدد الجذري الذي استُدعي معه إلى أقرب قيمة مع دقة محدَّدة للمنازل العشرية.

مصادر