remainder(3)

الاسم
drem, dremf, dreml, remainder, remainderf, remainderl - دالة باقي القسمة للفاصلة العائمة

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

موجز
#include <math.h>

double remainder(double x, double y);
float remainderf(float x, float y);
long double remainderl(long double x, long double y);

/* Obsolete synonyms */
[[deprecated]] double drem(double x, double y);
[[deprecated]] float dremf(float x, float y);
[[deprecated]] long double dreml(long double x, long double y);

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

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

remainderf(), remainderl():
    _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L
        || /* Since glibc 2.19: */ _DEFAULT_SOURCE
        || /* glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE

drem(), dremf(), dreml():
    /* منذ glibc 2.19: */ _DEFAULT_SOURCE
        || /* glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE

الوصف
تحسب هذه الدوال باقي قسمة x على y. قيمة الإرجاع هي x-n*y، حيث n هي قيمة x / y، مقربة إلى أقرب عدد صحيح. إذا كانت القيمة المطلقة لـ x-n*y تساوي 0.5، يُختار n ليكون زوجيًا.

لا تتأثر هذه الدوال بوضع التقريب الحالي (انظر fenv(3)).

تقوم الدالة drem() بنفس الشيء تمامًا.

قيمة الإرجاع
عند النجاح، تُرجع هذه الدوال باقي القسمة للفاصلة العائمة، x-n*y. إذا كانت قيمة الإرجاع 0، فإنها تحمل إشارة x.

إذا كان x أو y هو NaN، فسيُعاد NaN.

إذا كان x ما لا نهاية، و y ليس NaN، يحدث خطأ في النطاق، ويُعاد NaN.

إذا كان y صفرا، و x ليس NaN، يحدث خطأ في النطاق، ويُعاد NaN.

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

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

خطأ في المجال: x قيمة لا نهائية و y ليست NaN
    يُضبط errno على EDOM (لكن راجع BUGS). ويُثار استثناء نقطة عائمة غير صالح (FE_INVALID).

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

خطأ في النطاق: y هو صفر
    تُضبط errno على EDOM. وُيرفع استثناء نقطة عائمة غير صالح (FE_INVALID).

السمات
للاطلاع على شرح للمصطلحات المستخدمة في هذا القسم، انظر attributes(7).
الواجهة | السمة | القيمة
drem(), dremf(), dreml(), remainder(), remainderf(), remainderl() | سلامة الخيوط | MT-Safe

المعايير

remainder()
remainderf()
remainderl()
    C11, POSIX.1-2008.

drem()
dremf()
dreml()
    لا شيء.

التاريخ

remainder()
remainderf()
remainderl()
    C99، POSIX.1-2001.

drem()
    4.3BSD.

dremf()
dreml()
    Tru64، glibc2.

العلل
قبل الإصدار 2.15 من glibc، كان الاستدعاء

    remainder(nan(""), 0);

أرجع قيمة NaN، كما هو متوقع، لكنه تسبب خطأً في النطاق بشكل خاطئ. منذ الإصدار 2.15 من glibc، تُرجع قيمة NaN صامتة (أي بدون خطأ في النطاق).

قبل الإصدار 2.15 من glibc، لم تُضبط errno إلى EDOM لخطأ النطاق الذي يحدث عندما تكون x قيمة لانهائية وy ليست NaN.

أمثلة
الاستدعاء "remainder(29.0, 3.0)" يُرجع -1.

انظر أيضًا
div(3), fmod(3), remquo(3)

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

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

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