.\" -*- coding: UTF-8 -*-
'\" t
.\" Copyright 1993, David Metcalfe <david@prism.demon.co.uk>
.\" Copyright, the authors of the Linux man-pages project
.\"
.\" SPDX-License-Identifier: Linux-man-pages-copyleft
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH atanh 3 "8 فبراير 2026" "صفحات دليل لينكس 6.18" 
.SH الاسم
atanh, atanhf, atanhl \- دالة الظل الزائدي العكسي
.SH المكتبة
مكتبة الرياضيات (\fIlibm\fP،\ \fI\-lm\fP)
.SH موجز
.nf
\fB#include <math.h>\fP
.P
\fBdouble atanh(double \fP\fIx\fP\fB);\fP
\fBfloat atanhf(float \fP\fIx\fP\fB);\fP
\fBlong double atanhl(long double \fP\fIx\fP\fB);\fP
.P
.fi
.RS -4
متطلبات ماكروات اختبار الميزات لـ glibc (انظر \fBfeature_test_macros\fP(7)):
.RE
.P
\fBatanh\fP():
.nf
.\"    || _XOPEN_SOURCE && _XOPEN_SOURCE_EXTENDED
    _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L
        || _XOPEN_SOURCE >= 500
        || /* منذ glibc 2.19: */ _DEFAULT_SOURCE
        || /* glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE
.fi
.P
\fBatanhf\fP(), \fBatanhl\fP():
.nf
    _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L
        || /* Since glibc 2.19: */ _DEFAULT_SOURCE
        || /* glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE
.fi
.SH الوصف
تحسب هذه الدوال الظل الزائدي العكسي لـ \fIx\fP؛ أي القيمة التي ظلها الزائدي هو
\fIx\fP.
.SH "قيمة الإرجاع"
عند النجاح، تُرجع هذه الدوال الظل الزائدي العكسي لـ \fIx\fP.
.P
إذا كانت \fIx\fP ليست رقماً (NaN)، فسيُعاد NaN.
.P
إذا كانت \fIx\fP هي +0 (\-0)، فُيعاد +0 (\-0).
.P
إذا كان \fIx\fP هو +1 أو \-1، يحدث خطأ قطبي، وتُرجع الدوال \fBHUGE_VAL\fP أو
\fBHUGE_VALF\fP أو \fBHUGE_VALL\fP، على التوالي، بالإشارة الصحيحة رياضياً.
.P
.\"
.\" POSIX.1-2001 documents an optional range error for subnormal x;
.\" glibc 2.8 does not do this.
إذا كانت القيمة المطلقة لـ \fIx\fP أكبر من 1، يحدث خطأ نطاق، ويُعاد NaN.
.SH الأخطاء
انظر \fBmath_error\fP(7) لمعلومات حول كيفية تحديد ما إذا كان قد حدث خطأ عند
استدعاء هذه الدوال.
.P
الأخطاء التالية يمكن أن تحدث:
.TP 
خطأ نطاق: \f[I]x\fR أقل من \-1 أو أكبر من +1
تُضبط \fIerrno\fP على \fBEDOM\fP. وُيرفع استثناء نقطة عائمة غير صالح
(\fBFE_INVALID\fP).
.TP 
خطأ قطبي: \f[I]x\fR هو +1 أو \-1
يُضبط \fIerrno\fP على \fBERANGE\fP (لكن راجع BUGS). ويُثار استثناء نقطة عائمة
للقسمة على صفر (\fBFE_DIVBYZERO\fP).
.SH السمات
للاطلاع على شرح للمصطلحات المستخدمة في هذا القسم، انظر \fBattributes\fP(7).
.TS
allbox;
lbx lb lb
l l l.
الواجهة	السمة	القيمة
T{
.na
.nh
\fBatanh\fP(),
\fBatanhf\fP(),
\fBatanhl\fP()
T}	سلامة الخيوط	MT\-Safe
.TE
.SH المعايير
C11, POSIX.1\-2008.
.SH التاريخ
C99، POSIX.1\-2001.
.P
النسخة التي تُعيد \fIdouble\fP تتوافق أيضًا مع SVr4، و 4.3BSD.
.SH العلل
.\" Bug: https://www.sourceware.org/bugzilla/show_bug.cgi?id=6759
.\" This can be seen in sysdeps/ieee754/k_standard.c
في إصدار glibc 2.9 وما قبله، عند حدوث خطأ قطبي (pole error)، يُضبط \fIerrno\fP
على \fBEDOM\fP بدلاً من \fBERANGE\fP الذي يفرضه معيار POSIX. ومنذ glibc 2.10، تقوم
glibc بالإجراء الصحيح.
.SH "انظر أيضًا"
\fBacosh\fP(3), \fBasinh\fP(3), \fBcatanh\fP(3), \fBcosh\fP(3), \fBsinh\fP(3), \fBtanh\fP(3)
.PP
.SH ترجمة
تُرجمت هذه الصفحة من الدليل بواسطة
زايد السعيدي <zayed.alsaidi@gmail.com>
.
.PP
هذه الترجمة هي وثيقة مجانية؛ راجع
.UR https://www.gnu.org/licenses/gpl-3.0.html 
رخصة جنو العامة الإصدار 3
.UE
أو ما بعده للاطلاع على شروط حقوق النشر.
لا توجد أي ضمانات.
.PP
إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه،
يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين:
.MT kde-l10n-ar@kde.org
.ME .