scalb(3)

الاسم
scalb, scalbf, scalbl - القياس بواسطة قوة صحيحة للجذر (مُهجَر)

المكتبة
مكتبة الرياضيات (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);

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

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()، scalbf()، scalbl() | سلامة الخيوط | MT-Safe

المعايير
لا شيء.

التاريخ

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 (https://www.gnu.org/licenses/gpl-3.0.html) أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات.

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