الاسم¶

scalb, scalbf, scalbl - ضرب عدد فاصلة عائمة بقوة صحيحة للجذر (مُهجَر)

المكتبة¶

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

موجز¶

#include <math.h>

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

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) مرفوعًا للقوة exp، أي:

    x * FLT_RADIX ** exp

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

قيمة الإرجاع¶

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

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

إذا كانت x لا نهاية موجبة (لا نهاية سالبة)، و exp ليست لا نهاية سالبة، فتُرجَع لا نهاية موجبة (لا نهاية سالبة).

إذا كانت x هي +0 (-0)، و exp ليست لا نهاية موجبة، فتُرجَع +0 (-0).

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

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

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

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

الأخطاء¶

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

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

خطأ نطاق: x هي 0، و exp لا نهاية موجبة، أو x لا نهاية موجبة و exp لا نهاية سالبة والوسيط الآخر ليس 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.