الاسم

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

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).

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 أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات.

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