round(3)

الاسم
round, roundf, roundl - تقريب إلى أقرب عدد صحيح، بعيدًا عن الصفر

المكتبة
مكتبة الرياضيات (libm، -lm)

موجز
#include <math.h>

double round(double x);
float roundf(float x);
long double roundl(long double x);

    متطلبات ماكروات اختبار الميزات لـ glibc (انظر feature_test_macros(7)):

round(), roundf(), roundl():
    _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L

الوصف
تقرب هذه الدوال x إلى أقرب عدد صحيح، لكنها تقرب الحالات النصفية بعيدًا عن الصفر (بغض النظر عن اتجاه التقريب الحالي، انظر fenv(3))، بدلاً من التقريب إلى أقرب عدد صحيح زوجي مثل rint(3).

على سبيل المثال، round(0.5) هو 1.0، و round(-0.5) هو -1.0.

قيمة الإرجاع
تعيد هذه الدوال القيمة الصحيحة المقربة.

إذا كانت x عددًا صحيحًا، أو +0، أو -0، أو NaN، أو لا نهائية، تُعاد x نفسها.

الأخطاء
لم تحدث أخطاء.

السمات
للاطلاع على شرح للمصطلحات المستخدمة في هذا القسم، انظر attributes(7).
الواجهة | السمة | القيمة
round(), roundf(), roundl() | سلامة الخيوط | MT-Safe

المعايير
C11, POSIX.1-2008.

التاريخ
glibc 2.1. C99، POSIX.1-2001.

يحتوي POSIX.1-2001 على نص حول الفيض (الذي قد يضبط errno إلى ERANGE، أو يثير استثناء FE_OVERFLOW). عمليًا، لا يمكن للنتيجة أن تفيض على أي آلة حالية، لذا كانت معالجة الأخطاء هذه مجرد هراء. (بشكل أدق، يمكن أن يحدث الفيض فقط عندما تكون القيمة القصوى للأس أصغر من عدد بتات الجزء العشري. بالنسبة لأرقام الفاصلة العائمة 32-بت و64-بت وفق معيار IEEE-754، القيمة القصوى للأس هي 127 (و1023 على التوالي)، وعدد بتات الجزء العشري بما في ذلك البت الضمني هو 24 (و53 على التوالي).) أُزيل هذا في POSIX.1-2008.

إذا أردت تخزين القيمة المقربة في نوع عدد صحيح، فربما تريد استخدام إحدى الدوال الموصوفة في lround(3) بدلاً من ذلك.

انظر أيضًا
ceil(3), floor(3), lround(3), nearbyint(3), rint(3), trunc(3)

ترجمة
تُرجمت هذه الصفحة من الدليل بواسطة زايد السعيدي <zayed.alsaidi@gmail.com>

هذه الترجمة هي وثيقة مجانية؛ راجع رخصة جنو العامة الإصدار 3 (https://www.gnu.org/licenses/gpl-3.0.html) أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات.

إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه، يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين: kde-l10n-ar@kde.org.