expm1(3)

الاسم
expm1, expm1f, expm1l - الأسي ناقص 1

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

موجز
#include <math.h>

double expm1(double x);
float expm1f(float x);
long double expm1l(long double x);

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

expm1():
    _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L
        || _XOPEN_SOURCE >= 500
        || /* منذ glibc 2.19: */ _DEFAULT_SOURCE
        || /* glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE

expm1f(), expm1l():
    _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L
        || /* Since glibc 2.19: */ _DEFAULT_SOURCE
        || /* glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE

الوصف
تعيد هذه الدوال قيمة مكافئة لـ

    exp(x) - 1

يُحسب الناتج بطريقة دقيقة حتى لو كانت قيمة x قريبة من الصفر—حالة حيث exp(x) - 1 ستكون غير دقيقة بسبب طرح عددين متقاربين تقريبًا.

قيمة الإرجاع
عند النجاح، تُرجع هذه الدوال exp(x) - 1.

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

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

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

إذا كانت x سالبة ما لا نهاية، يُرجع -1.

إذا فاض الناتج، يحدث خطأ نطاق، وتُرجع الدوال -HUGE_VAL أو -HUGE_VALF أو -HUGE_VALL، على التوالي.

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

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

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

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

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

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

العلل
قبل glibc 2.17، على بعض البنى (مثل x86، وليس x86_64) أثارت expm1() استثناء تحت التدفق عائم وهمي لبعض قيم x السالبة الكبيرة (حيث يقترب ناتج الدالة من -1).

قبل حوالي glibc 2.11، أثارت expm1() استثناء عائم غير صالح وهمي بالإضافة إلى استثناء الفيض المتوقع، وأرجعت NaN بدلاً من ما لا نهاية موجب، لبعض قيم x الموجبة الكبيرة.

قبل glibc 2.11، لم يضبط تطبيق glibc errno إلى ERANGE عند حدوث خطأ نطاق.

انظر أيضًا
exp(3), log(3), log1p(3)

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

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

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