.\" -*- coding: UTF-8 -*-
.\" 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 lgamma 3 "8 فبراير 2026" "صفحات دليل لينكس 6.18" 
.SH الاسم
lgamma, lgammaf, lgammal, lgamma_r, lgammaf_r, lgammal_r, signgam \- دالة
لوغاريتم غاما
.SH المكتبة
مكتبة الرياضيات (\fIlibm\fP،\ \fI\-lm\fP)
.SH موجز
.nf
\fB#include <math.h>\fP
.P
\fBdouble lgamma(double \fP\fIx\fP\fB);\fP
\fBfloat lgammaf(float \fP\fIx\fP\fB);\fP
\fBlong double lgammal(long double \fP\fIx\fP\fB);\fP
.P
\fBdouble lgamma_r(double \fP\fIx\fP\fB, int *\fP\fIsignp\fP\fB);\fP
\fBfloat lgammaf_r(float \fP\fIx\fP\fB, int *\fP\fIsignp\fP\fB);\fP
\fBlong double lgammal_r(long double \fP\fIx\fP\fB, int *\fP\fIsignp\fP\fB);\fP
.P
\fBextern int \fP\fIsigngam\fP\fB;\fP
.fi
.P
.RS -4
متطلبات ماكروات اختبار الميزات لـ glibc (انظر \fBfeature_test_macros\fP(7)):
.RE
.P
.nf
\fBlgamma\fP():
    _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L || _XOPEN_SOURCE
        || /* Since glibc 2.19: */ _DEFAULT_SOURCE
        || /* glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE
.fi
.P
\fBlgammaf\fP(), \fBlgammal\fP():
.nf
    _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L
        || /* Since glibc 2.19: */ _DEFAULT_SOURCE
        || /* glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE
.fi
.P
\fBlgamma_r\fP(), \fBlgammaf_r\fP(), \fBlgammal_r\fP():
.nf
    /* منذ glibc 2.19: */ _DEFAULT_SOURCE
        || /* glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE
.fi
.P
\fIsigngam\fP:
.nf
    _XOPEN_SOURCE
        || /* منذ glibc 2.19: */ _DEFAULT_SOURCE
        || /* glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE
.fi
.SH الوصف
لتعريف دالة غاما، راجع \fBtgamma\fP(3).
.P
الدوال \fBlgamma\fP() و \fBlgammaf\fP() و \fBlgammal\fP() تُرجع اللوغاريتم الطبيعي
للقيمة المطلقة لدالة غاما. يُرجَع إشارة دالة غاما في العدد الصحيح الخارجي
\fIsigngam\fP المُصرَّح عنه في \fI<math.h>\fP. تكون القيمة 1 عندما تكون
دالة غاما موجبة أو صفرًا، و \-1 عندما تكون سالبة.
.P
بما أن استخدام موقع ثابت \fIsigngam\fP ليس آمنًا للخيوط، فقد أُدخلت الدوال
\fBlgamma_r\fP() و \fBlgammaf_r\fP() و \fBlgammal_r\fP()؛ فهي تُرجع الإشارة عبر
المعامل \fIsignp\fP.
.SH "قيمة الإرجاع"
عند النجاح، تُرجع هذه الدوال اللوغاريتم الطبيعي لـ Gamma(x).
.P
إذا كانت \fIx\fP ليست رقماً (NaN)، فسيُعاد NaN.
.P
إذا كان \fIx\fP يساوي 1 أو 2، يُرجَع +0.
.P
إذا كان \fIx\fP ما لا نهاية موجبة أو سالبة، تُعاد ما لا نهاية موجبة.
.P
إذا كان \fIx\fP عددًا صحيحًا غير موجب، يحدث خطأ قطبي، وتُرجِع الدوال
+\fBHUGE_VAL\fP أو +\fBHUGE_VALF\fP أو +\fBHUGE_VALL\fP، على التوالي.
.P
.\" e.g., lgamma(DBL_MAX)
إذا تجاوزت النتيجة السعة، يحدث خطأ في النطاق، وتعيد الدوال \fBHUGE_VAL\fP أو
\fBHUGE_VALF\fP أو \fBHUGE_VALL\fP على التوالي، مع الإشارة الرياضية الصحيحة.
.SH الأخطاء
انظر \fBmath_error\fP(7) لمعلومات حول كيفية تحديد ما إذا كان قد حدث خطأ عند
استدعاء هذه الدوال.
.P
الأخطاء التالية يمكن أن تحدث:
.TP 
خطأ قطبي: \f[I]x\fR عدد صحيح غير موجب
يُضبط \fIerrno\fP على \fBERANGE\fP (لكن راجع BUGS). ويُثار استثناء نقطة عائمة
للقسمة على صفر (\fBFE_DIVBYZERO\fP).
.TP 
خطأ في النطاق: طفح في النتيجة
.\" glibc (as at 2.8) also supports an inexact
.\" exception for various cases.
تُضبط \fIerrno\fP على \fBERANGE\fP. وُيرفع استثناء تجاوز نقطة عائمة
(\fBFE_OVERFLOW\fP).
.SH المعايير
.TP 
\fBlgamma\fP()
.TQ
\fBlgammaf\fP()
.TQ
\fBlgammal\fP()
C11, POSIX.1\-2008.
.TP 
\fIsigngam\fP
POSIX.1\-2008.
.TP 
\fBlgamma_r\fP()
.TQ
\fBlgammaf_r\fP()
.TQ
\fBlgammal_r\fP()
لا شيء.
.SH التاريخ
.TP 
\fBlgamma\fP()
.TQ
\fBlgammaf\fP()
.TQ
\fBlgammal\fP()
C99، POSIX.1\-2001.
.TP 
\fIsigngam\fP
POSIX.1\-2001.
.TP 
\fBlgamma_r\fP()
.TQ
\fBlgammaf_r\fP()
.TQ
\fBlgammal_r\fP()
لا شيء.
.SH العلل
.\" https://www.sourceware.org/bugzilla/show_bug.cgi?id=6777
في glibc 2.9 وما قبله، عند حدوث خطأ قطبي، يُضبط \fIerrno\fP على \fBEDOM\fP؛ بدلاً
من \fBERANGE\fP المطلوب من POSIX. منذ glibc 2.10، يفعل glibc الشيء الصحيح.
.SH "انظر أيضًا"
\fBtgamma\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 .