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

مراجعة 21:09، 15 أكتوبر 2018

يعيد التابع truncate‎ العدد الذي استُدعي معه مُقرّبًا (truncateed) إلى أقرب قيمة، مع دقة (precision) تساوي ndigits رقم عشري (القيمة الابتدائية هي 0) .

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

في حال كانت قيمة ndigits‎ منعدمة أو سالبة، فسيعيد التابع truncate‎ العدد الذي استُدعي معه.

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

truncate([ndigits])  →  integer or float‎

المعاملات

`ndigits‎`

عدد يحدد الدقة.

`half`

وسيط اختياري يعمل بشكل مماثل لعمله في الوسيط Float#round.

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

يعيد التابع truncate‎ العدد الذي استُدعي معه مُقرّبًا (truncateed) إلى أقرب قيمة، مع دقة (precision) تساوي ndigits رقم عشري (القيمة الابتدائية هي 0) .

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

في حال كانت قيمة ndigits‎ منعدمة أو سالبة، فسيعيد التابع truncate‎ العدد الذي استُدعي معه.

أمثلة

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

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

انظر أيضا

التابع round: يعيد التابع round‎ العدد الذي استُدعي معه مُقرّبًا (rounded) إلى أقرب قيمة، مع دقة (precision) تساوي ndigits رقم عشري (القيمة الابتدائية هي 0) .

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

في حال كانت قيمة ndigits‎ منعدمة أو سالبة، فسيعيد التابع round‎ العدد الذي استُدعي معه.

التابع ceil: يعيد التابع round‎ العدد الذي استُدعي معه مُقرّبًا (rounded) إلى أقرب قيمة، مع دقة (precision) تساوي ndigits رقم عشري (القيمة الابتدائية هي 0) .

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

في حال كانت قيمة ndigits‎ منعدمة أو سالبة، فسيعيد التابع round‎ العدد الذي استُدعي معه.

مصادر

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

@@ سطر 3: / سطر 3: @@
 [[تصنيف: Ruby Method]]
 [[تصنيف: Ruby Integer]]
-يعيد التابع <code>to_s‎</code> سلسلة نصية تحتوي على التمثيل الموضعي (place-value representation) للعدد الذي استُدعي معه، وفق الأساس (radix) المعطى <code>base</code> (محصور بين <code>2</code> و <code>36</code>)
+يعيد التابع <code>truncate‎</code> العدد الذي استُدعي معه مُقرّبًا (truncateed) إلى أقرب قيمة، مع دقة (precision) تساوي <code>ndigits</code> رقم عشري (القيمة الابتدائية هي <code>0</code>) .
+إذا كانت الدقة سالبة، فإنّ القيمة المعادة ستكون عددًا صحيحًا مع <code>ndigits.abs</code> صفر إضافي على الأقل.
+في حال كانت قيمة  <code>ndigits‎</code> منعدمة أو سالبة، فسيعيد التابع <code>truncate‎</code> العدد الذي استُدعي معه.
 ==البنية العامة==
 <syntaxhighlight lang="ruby">truncate([ndigits])  →  integer or float‎</syntaxhighlight>
 ==المعاملات==
-===<code>base‎</code>===
+===<code>ndigits‎</code>===
-عدد صحيح يمثل أساس عملية  التمثيل الموضعي (place-value representation).
+عدد يحدد الدقة.
+=== <code>half</code> ===
+وسيط اختياري يعمل بشكل مماثل لعمله في الوسيط [[Ruby/Float/round|Float#round]].
 ==القيمة المُعادة==
-يعيد التابع <code>to_s‎</code> سلسلة نصية تحتوي على التمثيل الموضعي (place-value representation) للعدد الذي استُدعي معه، وفق الأساس (radix) المعطى <code>base</code> (محصور بين <code>2</code> و <code>36</code>)
+يعيد التابع <code>truncate‎</code> العدد الذي استُدعي معه مُقرّبًا (truncateed) إلى أقرب قيمة، مع دقة (precision) تساوي <code>ndigits</code> رقم عشري (القيمة الابتدائية هي <code>0</code>) .
+إذا كانت الدقة سالبة، فإنّ القيمة المعادة ستكون عددًا صحيحًا مع <code>ndigits.abs</code> صفر إضافي على الأقل.
+في حال كانت قيمة  <code>ndigits‎</code> منعدمة أو سالبة، فسيعيد التابع <code>truncate‎</code> العدد الذي استُدعي معه.
 ==أمثلة==
 مثال على استخدام التابع <code>truncate‎</code>:
@@ سطر 23: / سطر 47: @@
 ‎</syntaxhighlight>
 ==انظر أيضا==
-* التابع <code>[[Ruby/Integer/round|round]]</code>: يعيد التابع <code>to_s‎</code> سلسلة نصية تحتوي على التمثيل الموضعي (place-value representation) للعدد الذي استُدعي معه، وفق الأساس (radix) المعطى <code>base</code> (محصور بين <code>2</code> و <code>36</code>)
+* التابع <code>[[Ruby/Integer/round|round]]</code>: يعيد التابع <code>round‎</code> العدد الذي استُدعي معه مُقرّبًا (rounded) إلى أقرب قيمة، مع دقة (precision) تساوي <code>ndigits</code> رقم عشري (القيمة الابتدائية هي <code>0</code>) .
-* التابع <code>[[Ruby/Integer/ceil|ceil]]</code>: يعيد التابع <code>to_s‎</code> سلسلة نصية تحتوي على التمثيل الموضعي (place-value representation) للعدد الذي استُدعي معه، وفق الأساس (radix) المعطى <code>base</code> (محصور بين <code>2</code> و <code>36</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‎ في توثيق روبي الرسمي.]