remquo(3)

الاسم
remquo, remquof, remquol - الباقي وجزء من خارج القسمة

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

موجز
#include <math.h>

double remquo(double x, double y, int *quo);
float remquof(float x, float y, int *quo);
long double remquol(long double x, long double y, int *quo);

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

remquo(), remquof(), remquol():
    _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L

الوصف
تحسب هذه الدوال الباقي وجزءًا من خارج القسمة عند قسمة x على y. تُخزَّن بضع بتات من خارج القسمة عبر المؤشر quo. يُعاد الباقي كنتيجة للدالة.

قيمة الباقي هي نفس القيمة التي تحسبها الدالة remainder(3).

للقيمة المخزنة عبر المؤشر quo إشارة x / y وتتوافق مع خارج القسمة في أقل 3 بتات على الأقل.

على سبيل المثال، تُعيد remquo(29.0, 3.0) القيمة -1.0 وقد تخزن 2. لاحظ أن خارج القسمة الفعلي قد لا يسع في عدد صحيح.

قيمة الإرجاع
عند النجاح، تُعيد هذه الدوال نفس القيمة التي تُعيدها الدوال المماثلة الموصوفة في remainder(3).

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

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

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

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

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

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

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

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

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

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

انظر أيضًا
fmod(3), logb(3), remainder(3)

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

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

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