ldexp(3)

الاسم
ldexp، ldexpf، ldexpl - ضرب عدد فاصل عائم بقوة صحيحة للعدد 2

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

موجز
#include <math.h>

double ldexp(double x, int e);
float ldexpf(float x, int e);
long double ldexpl(long double x, int e);

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

ldexpf()، ldexpl():
    _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L
        || /* Since glibc 2.19: */ _DEFAULT_SOURCE
        || /* glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE

الوصف
تُرجع هذه الدوال نتيجة ضرب العدد الفاصل العائم x في 2 مرفوعًا للقوة e.

قيمة الإرجاع
عند النجاح، تُرجع هذه الدوال x * (2^e).

إذا كان e صفرًا، فسيُعاد x.

إذا كانت x ليست رقماً (NaN)، فسيُعاد NaN.

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

إذا نقصت النتيجة عن أدنى قيمة، يحدث خطأ في النطاق، وتُعاد القيمة صفر.

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

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

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

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

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

السمات
للاطلاع على شرح للمصطلحات المستخدمة في هذا القسم، انظر attributes(7).
الواجهة | السمة | القيمة
ldexp(), ldexpf(), ldexpl() | سلامة الخيوط | MT-Safe

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

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

النسخة التي تُعيد double تتوافق أيضًا مع SVr4، و 4.3BSD، و C89.

انظر أيضًا
frexp(3)، modf(3)، scalbln(3)

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

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

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