الاسم

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

#include <math.h>

[[مُهجَر]] double scalb(double x, double e);
[[مُهجَر]] float scalbf(float x, float e);
[[مُهجَر]] long double scalbl(long double x, long double e);

scalb():

    _XOPEN_SOURCE >= 500
        || /* منذ glibc 2.19: */ _DEFAULT_SOURCE
        || /* glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE

scalbf(), scalbl():

    _XOPEN_SOURCE >= 600
        || /* منذ glibc 2.19: */ _DEFAULT_SOURCE
        || /* glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE

تضرب هذه الدوال معاملها الأول x في FLT_RADIX (على الأرجح 2) مرفوعًا للقوة e، أي:

    x * FLT_RADIX ** e

يمكن الحصول على تعريف FLT_RADIX عبر تضمين <float.h>.

عند النجاح، تعيد هذه الدوال x * FLT_RADIX ** e.

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

إذا كان x هو لا نهاية موجبة (لا نهاية سالبة)، وe ليس لا نهاية سالبة، تُعاد لا نهاية موجبة (لا نهاية سالبة).

إذا كان x هو +0 (-0)، وe ليس لا نهاية موجبة، يُعاد +0 (-0).

إذا كان x صفرًا، وe لا نهاية موجبة، يحدث خطأ نطاق، ويُعاد NaN.

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

إذا فاضت النتيجة، يحدث خطأ في النطاق، وتعيد الدوال HUGE_VAL، أو HUGE_VALF، أو HUGE_VALL على التوالي، مع إشارة مماثلة لـ x.

إذا نقصت النتيجة عن أدنى قيمة (underflow)، يحدث خطأ في النطاق، وتعيد الدوال صفراً، بنفس إشارة x.

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

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

خطأ نطاق: x هو 0، وe لا نهاية موجبة، أو x لا نهاية موجبة وe لا نهاية سالبة والوسيط الآخر ليس NaN

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

خطأ في النطاق، فيض

تُضبط errno على ERANGE. وُيرفع استثناء تجاوز نقطة عائمة (FE_OVERFLOW).

خطأ في النطاق، فيض تحتي

يُضبط errno على ERANGE. ويُثار استثناء فيض سفلي للنقطة العائمة (FE_UNDERFLOW).

للاطلاع على شرح للمصطلحات المستخدمة في هذا القسم، انظر attributes(7).

لا شيء.

scalb()

4.3BSD. مُهجَر في POSIX.1-2001؛ أُزيل في POSIX.1-2008، مع التوصية باستخدام scalbln(3)، scalblnf(3)، أو scalblnl(3) بدلاً من ذلك.

قبل glibc 2.20، لم تضبط هذه الدوال errno لأخطاء النطاق والمدى.

ldexp(3)، scalbln(3)

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

هذه الترجمة هي وثيقة مجانية؛ راجع رخصة جنو العامة الإصدار 3 أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات.

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