lround(3)

الاسم
lround, lroundf, lroundl, llround, llroundf, llroundl - تقريب إلى أقرب عدد صحيح

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

موجز
#include <math.h>

long lround(double x);
long lroundf(float x);
long lroundl(long double x);

long long llround(double x);
long long llroundf(float x);
long long llroundl(long double x);

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

كافة الدوال الموضحة أعلاه:
    _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L

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

لاحظ أنه على عكس الدالتين round(3) و ceil(3)، فإن نوع الإرجاع لهذه الدوال يختلف عن نوع معاملاتها.

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

إذا كان x هو NaN أو ما لا نهاية، أو كانت القيمة المقربة أكبر من أن تُخزن في نوع long (أو long long في حالة دوال ll*)، يحدث خطأ في النطاق وتكون القيمة المعادة غير محددة.

الأخطاء
انظر math_error(7) لمعلومات حول كيفية تحديد ما إذا كان قد حدث خطأ عند استدعاء هذه الدوال.

الأخطاء التالية يمكن أن تحدث:

خطأ في النطاق: x ليس رقماً (NaN) أو لانهائي، أو القيمة المقربة كبيرة جداً
    رُفع استثناء نقطة عائمة غير صالحة (FE_INVALID).

هذه الدوال لا تضبط errno.

السمات
للاطلاع على شرح للمصطلحات المستخدمة في هذا القسم، انظر attributes(7).
الواجهة | السمة | القيمة
lround()، lroundf()، lroundl()، llround()، llroundf()، llroundl() | سلامة الخيوط | MT-Safe

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

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

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

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

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

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