rint(3)

الاسم
nearbyint، nearbyintf، nearbyintl، rint، rintf، rintl - تقريب إلى أقرب عدد صحيح

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

موجز
#include <math.h>

double nearbyint(double x);
float nearbyintf(float x);
long double nearbyintl(long double x);

double rint(double x);
float rintf(float x);
long double rintl(long double x);

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

nearbyint()، nearbyintf()، nearbyintl():
    _POSIX_C_SOURCE >= 200112L || _ISOC99_SOURCE

rint():
    _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L
        || _XOPEN_SOURCE >= 500
        || /* منذ glibc 2.19: */ _DEFAULT_SOURCE
        || /* glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE

rintf()، rintl():
    _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L
        || /* Since glibc 2.19: */ _DEFAULT_SOURCE
        || /* glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE

الوصف
تُقرّب الدوال nearbyint() و nearbyintf() و nearbyintl() وسيطها إلى قيمة صحيحة بصيغة النقطة العائمة، باستخدام اتجاه التقريب الحالي (انظر fesetround(3)) ودون إثارة استثناء inexact. عندما يكون اتجاه التقريب الحالي إلى الأقرب، تُقرّب هذه الدوال الحالات النصفية إلى العدد الصحيح الزوجي وفقًا لـ IEEE-754.

تفعل الدوال rint() و rintf() و rintl() نفس الشيء، لكنها تُثير استثناء inexact (FE_INEXACT، يمكن التحقق منه عبر fetestexcept(3)) عندما تختلف قيمة النتيجة عن الوسيط.

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

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

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

السمات
للاطلاع على شرح للمصطلحات المستخدمة في هذا القسم، انظر attributes(7).
الواجهة | السمة | القيمة
nearbyint(), nearbyintf(), nearbyintl(), rint(), rintf(), rintl() | سلامة الخيوط | MT-Safe

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

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

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

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

انظر أيضًا
ceil(3)، floor(3)، lrint(3)، round(3)، trunc(3)

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

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

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