scalbln(3)

الاسم
scalbn, scalbnf, scalbnl, scalbln, scalblnf, scalblnl - توسيع بقوة صحيحة للأساس

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

موجز
#include <math.h>

double scalbln(double x, long e);
float scalblnf(float x, long e);
long double scalblnl(long double x, long e);

double scalbn(double x, int e);
float scalbnf(float x, int e);
long double scalbnl(long double x, int e);

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

scalbln(), scalblnf(), scalblnl():
    _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L
        || /* Since glibc 2.19: */ _DEFAULT_SOURCE

scalbn(), scalbnf(), scalbnl():
    _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L
        || /* Since 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 ليست رقماً (NaN)، فسيُعاد NaN.

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

إذا كانت x هي +0 (-0)، فُيعاد +0 (-0).

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

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

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

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

خطأ في النطاق، فيض
    يُثار استثناء طفح النقطة العائمة (FE_OVERFLOW).

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

السمات
للاطلاع على شرح للمصطلحات المستخدمة في هذا القسم، انظر attributes(7).
الواجهة | السمة | القيمة
scalbn(), scalbnf(), scalbnl(), scalbln(), scalblnf(), scalblnl() | سلامة الخيوط | MT-Safe

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

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

التاريخ
تختلف هذه الدوال عن الدوال المهملة الموصوفة في scalb(3) في نوع معاملها الثاني. الدوال الموصوفة في هذه الصفحة لها معامل ثانٍ من نوع صحيح، بينما تلك الموجودة في scalb(3) لها معامل ثانٍ من النوع double.

ملاحظات
إذا كان FLT_RADIX يساوي 2 (وهو المعتاد)، فإن scalbn() يعادل ldexp(3).

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

انظر أيضًا
ldexp(3), scalb(3)

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

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

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