.\" -*- coding: UTF-8 -*-
'\" t
.\" Copyright 2002, Walter Harms <walter.harms@informatik.uni-oldenburg.de>
.\" Copyright, the authors of the Linux man-pages project
.\"
.\" SPDX-License-Identifier: GPL-1.0-or-later
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH tgamma 3 "8 فبراير 2026" "صفحات دليل لينكس 6.18" 
.SH الاسم
tgamma, tgammaf, tgammal \- دالة جاما الحقيقية
.SH المكتبة
مكتبة الرياضيات (\fIlibm\fP،\ \fI\-lm\fP)
.SH موجز
.nf
\fB#include <math.h>\fP
.P
\fBdouble tgamma(double \fP\fIx\fP\fB);\fP
\fBfloat tgammaf(float \fP\fIx\fP\fB);\fP
\fBlong double tgammal(long double \fP\fIx\fP\fB);\fP
.fi
.P
.RS -4
متطلبات ماكروات اختبار الميزات لـ glibc (انظر \fBfeature_test_macros\fP(7)):
.RE
.P
\fBtgamma\fP()، \fBtgammaf\fP()، \fBtgammal\fP():
.nf
    _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L
.fi
.SH الوصف
تحسب هذه الدوال دالة غاما للمُعامل \fIx\fP.
.P
تُعرّف دالة غاما بالعلاقة
.P
.RS
Gamma(x) = تكامل من 0 إلى ما لا نهاية لـ t\[ha](x\-1) e\[ha]\-t dt
.RE
.P
تُعرّف لكل عدد حقيقي باستثناء الأعداد الصحيحة غير الموجبة.  للعدد الصحيح غير
السالب \fIm\fP لدينا
.P
.RS
Gamma(m+1) = m!
.RE
.P
وبشكل أعم، لكل \fIx\fP:
.P
.RS
Gamma(x+1) = x * Gamma(x)
.RE
.P
علاوة على ذلك، يصح التالي لكل قيم \fIx\fP خارج الأقطاب:
.P
.RS
Gamma(x) * Gamma(1 \- x) = PI / sin(PI * x)
.RE
.SH "قيمة الإرجاع"
عند النجاح، تُرجع هذه الدوال Gamma(x).
.P
إذا كانت \fIx\fP ليست رقماً (NaN)، فسيُعاد NaN.
.P
إذا كانت \fIx\fP لانهاية موجبة، فستُعاد لانهاية موجبة.
.P
إذا كان \fIx\fP عددًا صحيحًا سالبًا، أو سالب ما لا نهاية، يحدث خطأ نطاق، ويُعاد
NaN.
.P
إذا تجاوزت النتيجة السعة، يحدث خطأ في النطاق، وتعيد الدوال \fBHUGE_VAL\fP أو
\fBHUGE_VALF\fP أو \fBHUGE_VALL\fP على التوالي، مع الإشارة الرياضية الصحيحة.
.P
إذا كان الناتج أقل من الحد الأدنى، يحدث خطأ مدى، وتُعيد الدوال 0، مع الإشارة
الرياضية الصحيحة.
.P
إذا كان \fIx\fP هو \-0 أو +0، يحدث خطأ قطب، وتُعيد الدوال \fBHUGE_VAL\fP أو
\fBHUGE_VALF\fP أو \fBHUGE_VALL\fP، على التوالي، بنفس إشارة الصفر.
.SH الأخطاء
انظر \fBmath_error\fP(7) لمعلومات حول كيفية تحديد ما إذا كان قد حدث خطأ عند
استدعاء هذه الدوال.
.P
الأخطاء التالية يمكن أن تحدث:
.TP 
خطأ نطاق: \f[I]x\fR عدد صحيح سالب، أو سالب ما لا نهاية
يُضبط \fIerrno\fP إلى \fBEDOM\fP.  يُثار استثناء فاصلة عائمة غير صالح
(\fBFE_INVALID\fP) (لكن انظر الأخطاء).
.TP 
خطأ قطب: \f[I]x\fR هو +0 أو \-0
ضُبط \fIerrno\fP على \fBERANGE\fP. رُفع استثناء نقطة عائمة للقسمة على صفر
(\fBFE_DIVBYZERO\fP).
.TP 
خطأ في النطاق: طفح في النتيجة
تُضبط \fIerrno\fP على \fBERANGE\fP. وُيرفع استثناء تجاوز نقطة عائمة
(\fBFE_OVERFLOW\fP).
.P
يُعطي glibc أيضًا الخطأ التالي غير المُحدد في C99 أو POSIX.1\-2001.
.TP 
خطأ في النطاق: فيض تحتي في النتيجة
.\" e.g., tgamma(-172.5) on glibc 2.8/x86-32
.\" .I errno
.\" is set to
.\" .BR ERANGE .
.\" glibc (as at 2.8) also supports an inexact
.\" exception for various cases.
يُثار استثناء عائم تحت التدفق (\fBFE_UNDERFLOW\fP)، ويُضبط \fIerrno\fP على
\fBERANGE\fP.
.SH السمات
للاطلاع على شرح للمصطلحات المستخدمة في هذا القسم، انظر \fBattributes\fP(7).
.TS
allbox;
lbx lb lb
l l l.
الواجهة	السمة	القيمة
T{
.na
.nh
\fBtgamma\fP(),
\fBtgammaf\fP(),
\fBtgammal\fP()
T}	سلامة الخيوط	MT\-Safe
.TE
.SH المعايير
C11, POSIX.1\-2008.
.SH التاريخ
glibc 2.1.  C99، POSIX.1\-2001.
.SH ملاحظات
كان يجب تسمية هذه الدالة "دالة غاما الحقيقية" نظرًا لوجود دالة \fBgamma\fP(3)
تُرجع شيئًا آخر (انظر \fBgamma\fP(3) للتفاصيل).
.SH العلل
.\" https://www.sourceware.org/bugzilla/show_bug.cgi?id=6809
قبل glibc 2.18، لم يضبط تطبيق glibc لهذه الدوال \fIerrno\fP على \fBEDOM\fP عندما
تكون \fIx\fP سالبة اللانهاية.
.P
.\" https://www.sourceware.org/bugzilla/show_bug.cgi?id=6810
قبل glibc 2.19، لم يضبط تطبيق glibc لهذه الدوال \fIerrno\fP على \fBERANGE\fP عند
خطأ نطاق تحت التدفق.
.P
.\"
في إصدارات glibc 2.3.3 وما قبلها، أنتجت وسيطة +0 أو \-0 خطأ نطاق (يُضبط
\fIerrno\fP على \fBEDOM\fP ويُثار استثناء \fBFE_INVALID\fP) بشكل غير صحيح، بدلاً من
خطأ قطب.
.SH "انظر أيضًا"
\fBgamma\fP(3)، \fBlgamma\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 .