log1p(3)

الاسم
log1p, log1pf, log1pl - لوغاريتم 1 زائد المُعامل

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

موجز
#include <math.h>

double log1p(double x);
float log1pf(float x);
long double log1pl(long double x);

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

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

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

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

    log(1 + x)

تُحسب النتيجة بطريقة دقيقة حتى لو كانت قيمة x قريبة من الصفر.

قيمة الإرجاع
عند النجاح، تُرجع هذه الدوال اللوغاريتم الطبيعي لـ (1 + x).

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

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

إذا كان x يساوي -1، يحدث خطأ قطبي، وتُرجع الدوال -HUGE_VAL أو -HUGE_VALF أو -HUGE_VALL، على التوالي.

إذا كان x أقل من -1 (بما في ذلك اللانهاية السالبة)، يحدث خطأ نطاق، وتُعاد قيمة NaN (ليس رقمًا).

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

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

خطأ نطاق: x أقل من -1.
    يُضبط errno على EDOM (لكن راجع BUGS). ويُثار استثناء نقطة عائمة غير صالح (FE_INVALID).

خطأ قطبي: x يساوي -1.
    يُضبط errno على ERANGE (لكن راجع BUGS). ويُثار استثناء نقطة عائمة للقسمة على صفر (FE_DIVBYZERO).

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

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

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

العلل
قبل glibc 2.22، لم يقم تنفيذ glibc بضبط errno على EDOM عند حدوث خطأ في النطاق.

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

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

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

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

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