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

المراجعة الحالية بتاريخ 07:21، 15 نوفمبر 2018

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

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

truncate([ndigits])  →  integer or float‎

المعاملات

`ndigits‎`

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

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

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

أمثلة

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

1.truncate           #=> 1
1.truncate(2)        #=> 1
18.truncate(-1)      #=> 10
(-18).truncate(-1)   #=> -10
‎

انظر أيضا

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

مصادر

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

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: التابع <code>truncate‎</code> الخاص بالصنف <code>Integer</code> في روبي}}</noinclude>
+<noinclude>{{DISPLAYTITLE: التابع <code>Integer.truncate‎</code> في روبي}}</noinclude>
 [[تصنيف: Ruby]]
 [[تصنيف: Ruby Method]]
 [[تصنيف: Ruby Integer]]
-يعيد التابع <code>truncate‎</code> العدد الذي استُدعي معه مُقرّبًا (truncateed) إلى أقرب قيمة، مع دقة (precision) تساوي <code>ndigits</code> رقم عشري (القيمة الابتدائية هي <code>0</code>) .
+يعيد التابع <code>truncate‎</code> العدد الذي استُدعي معه بعد اقتطاعه إلى دقة (precision) محدَّدة.
-إذا كانت الدقة سالبة، فإنّ القيمة المعادة ستكون عددًا صحيحًا مع <code>ndigits.abs</code> صفر إضافي على الأقل.
-في حال كانت قيمة  <code>ndigits‎</code> منعدمة أو سالبة، فسيعيد التابع <code>truncate‎</code> العدد الذي استُدعي معه.
 ==البنية العامة==
 <syntaxhighlight lang="ruby">truncate([ndigits])  →  integer or float‎</syntaxhighlight>
 ==المعاملات==
+=== <code>ndigits‎</code> ===
+عدد يحدد الدقة. إذا كانت الدقة سالبة، فإنّ القيمة المعادة ستكون عددًا صحيحًا مع <code>ndigits.abs</code> صفر إضافي على الأقل. في حال كانت قيمة <code>ndigits‎</code> منعدمة أو موجبة، فسيعيد التابع <code>truncate‎</code> العدد الذي استُدعي معه. القيمة الافتراضية هي: 0.
-===<code>ndigits‎</code>===
+==القيمة المعادة==
+يعيد التابع <code>truncate‎</code> العدد الذي استُدعي معه مُقتطعًا وفق دقة (precision) تساوي <code>ndigits</code> رقم عشري. إذا كانت الدقة سالبة، فإنّ القيمة المعادة ستكون عددًا صحيحًا مع <code>ndigits.abs</code> صفر إضافي على الأقل. في حال كانت قيمة <code>ndigits‎</code> منعدمة أو موجبة، فسيعيد التابع <code>truncate‎</code> العدد الذي استُدعي معه.
-عدد يحدد الدقة.
-=== <code>half</code> ===
-وسيط اختياري يعمل بشكل مماثل لعمله في الوسيط [[Ruby/Float/round|Float#round]].
-==القيمة المُعادة==
-يعيد التابع <code>truncate‎</code> العدد الذي استُدعي معه مُقرّبًا (truncateed) إلى أقرب قيمة، مع دقة (precision) تساوي <code>ndigits</code> رقم عشري (القيمة الابتدائية هي <code>0</code>) .
-إذا كانت الدقة سالبة، فإنّ القيمة المعادة ستكون عددًا صحيحًا مع <code>ndigits.abs</code> صفر إضافي على الأقل.
-في حال كانت قيمة  <code>ndigits‎</code> منعدمة أو سالبة، فسيعيد التابع <code>truncate‎</code> العدد الذي استُدعي معه.
 ==أمثلة==
 مثال على استخدام التابع <code>truncate‎</code>:
@@ سطر 47: / سطر 20: @@
 ‎</syntaxhighlight>
 ==انظر أيضا==
-* التابع <code>[[Ruby/Integer/round|round]]</code>: يعيد التابع <code>round‎</code> العدد الذي استُدعي معه مُقرّبًا (rounded) إلى أقرب قيمة، مع دقة (precision) تساوي <code>ndigits</code> رقم عشري (القيمة الابتدائية هي <code>0</code>) .
+* التابع <code>[[Ruby/Integer/round|round]]</code>: يقرِّب العدد الذي استُدعي معه إلى أقرب قيمة مع دقة (precision) تساوي العدد الممرر إليه.
+* التابع <code>[[Ruby/Integer/ceil|ceil]]</code>: يعيد أصغر عدد من الأعداد الأكبر من أو تساوي قيمة العدد الذي استُدعي معه.
-إذا كانت الدقة سالبة، فإنّ القيمة المعادة ستكون عددًا صحيحًا مع <code>ndigits.abs</code> صفر إضافي على الأقل.
-في حال كانت قيمة  <code>ndigits‎</code> منعدمة أو سالبة، فسيعيد التابع <code>round‎</code> العدد الذي استُدعي معه.
-* التابع <code>[[Ruby/Integer/ceil|ceil]]</code>: يعيد التابع <code>round‎</code> العدد الذي استُدعي معه مُقرّبًا (rounded) إلى أقرب قيمة، مع دقة (precision) تساوي <code>ndigits</code> رقم عشري (القيمة الابتدائية هي <code>0</code>) .
-إذا كانت الدقة سالبة، فإنّ القيمة المعادة ستكون عددًا صحيحًا مع <code>ndigits.abs</code> صفر إضافي على الأقل.
-في حال كانت قيمة  <code>ndigits‎</code> منعدمة أو سالبة، فسيعيد التابع <code>round‎</code> العدد الذي استُدعي معه.
 ==مصادر==
-*[http://ruby-doc.org/core-2.5.1/Integer.html#method-i-truncate قسم  التابع truncate‎ في الصنف Integer‎ في توثيق روبي الرسمي.]
+*[http://ruby-doc.org/core-2.5.1/Integer.html#method-i-truncate قسم التابع truncate‎ في الصنف Integer‎ في توثيق روبي الرسمي.]