atanh(3)

الاسم
atanh, atanhf, atanhl - دالة الظل الزائدي العكسي

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

موجز
#include <math.h>

double atanh(double x);
float atanhf(float x);
long double atanhl(long double x);

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

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

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

الوصف
تحسب هذه الدوال الظل الزائدي العكسي لـ x؛ أي القيمة التي ظلها الزائدي هو x.

قيمة الإرجاع
عند النجاح، تُرجع هذه الدوال الظل الزائدي العكسي لـ x.

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

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

إذا كان x هو +1 أو -1، يحدث خطأ قطبي، وتُرجع الدوال HUGE_VAL أو HUGE_VALF أو HUGE_VALL، على التوالي، بالإشارة الصحيحة رياضياً.

إذا كانت القيمة المطلقة لـ x أكبر من 1، يحدث خطأ نطاق، ويُعاد NaN.

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

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

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

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

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

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

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

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

العلل
في إصدار glibc 2.9 وما قبله، عند حدوث خطأ قطبي (pole error)، يُضبط errno على EDOM بدلاً من ERANGE الذي يفرضه معيار POSIX. ومنذ glibc 2.10، تقوم glibc بالإجراء الصحيح.

انظر أيضًا
acosh(3), asinh(3), catanh(3), cosh(3), sinh(3), tanh(3)

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

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

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