.\" -*- 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 tan 3 "8 فبراير 2026" "صفحات دليل لينكس 6.18" 
.SH الاسم
tan, tanf, tanl \- دالة الظل
.SH المكتبة
مكتبة الرياضيات (\fIlibm\fP،\ \fI\-lm\fP)
.SH موجز
.nf
\fB#include <math.h>\fP
.P
\fBdouble tan(double \fP\fIx\fP\fB);\fP
\fBfloat tanf(float \fP\fIx\fP\fB);\fP
\fBlong double tanl(long double \fP\fIx\fP\fB);\fP
.fi
.P
.RS -4
متطلبات ماكروات اختبار الميزات لـ glibc (انظر \fBfeature_test_macros\fP(7)):
.RE
.P
\fBtanf\fP()، \fBtanl\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 لانهاية موجبة أو لانهاية سالبة، فسيحدث خطأ نطاق، ويُعاد NaN
(ليس رقماً).
.P
.\" I think overflow can't occur, because the closest floating-point
.\" representation of pi/2 is still not close enough to pi/2 to
.\" produce a large enough value to overflow.
.\" Testing certainly seems to bear this out.  -- mtk, Jul 08
.\"
.\" POSIX.1 allows an optional underflow error;
.\" glibc 2.8 doesn't do this
.\" POSIX.1 an optional range error for subnormal x;
.\" glibc 2.8 doesn't do this
إذا كان من شأن النتيجة الصحيحة أن تفيض، يحدث خطأ نطاق، وتُرجع الدوال
\fBHUGE_VAL\fP أو \fBHUGE_VALF\fP أو \fBHUGE_VALL\fP، على التوالي، مع الإشارة الصحيحة
رياضيًا.
.SH الأخطاء
انظر \fBmath_error\fP(7) لمعلومات حول كيفية تحديد ما إذا كان قد حدث خطأ عند
استدعاء هذه الدوال.
.P
الأخطاء التالية يمكن أن تحدث:
.TP 
خطأ في النطاق: \f[I]x\fR هي ما لا نهاية
يُضبط \fIerrno\fP على \fBEDOM\fP (لكن راجع BUGS). ويُثار استثناء نقطة عائمة غير
صالح (\fBFE_INVALID\fP).
.TP 
خطأ في النطاق: طفح في النتيجة
.\" Unable to test this case, since the best approximation of
.\" pi/2 in double precision only yields a tan() value of 1.633e16.
.\" .I errno
.\" is set to
.\" .BR ERANGE .
يُثار استثناء طفح النقطة العائمة (\fBFE_OVERFLOW\fP).
.SH السمات
للاطلاع على شرح للمصطلحات المستخدمة في هذا القسم، انظر \fBattributes\fP(7).
.TS
allbox;
lbx lb lb
l l l.
الواجهة	السمة	القيمة
T{
.na
.nh
\fBtan\fP()،
\fBtanf\fP()،
\fBtanl\fP()
T}	سلامة الخيوط	MT\-Safe
.TE
.SH المعايير
C11, POSIX.1\-2008.
.SH التاريخ
C99، POSIX.1\-2001.
.P
النسخة التي تُعيد \fIdouble\fP تتوافق أيضًا مع SVr4، و 4.3BSD، و C89.
.SH العلل
.\" http://sourceware.org/bugzilla/show_bug.cgi?id=6782
قبل glibc 2.10، لم يقم تنفيذ glibc بضبط \fIerrno\fP إلى \fBEDOM\fP عند حدوث خطأ في
النطاق.
.SH "انظر أيضًا"
\fBacos\fP(3)، \fBasin\fP(3)، \fBatan\fP(3)، \fBatan2\fP(3)، \fBcos\fP(3)، \fBctan\fP(3)،
\fBsin\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 .