.\" -*- coding: UTF-8 -*-
'\" t
.\" Copyright 1995, James R. Van Zandt <jrv@vanzandt.mv.com>
.\" 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 log1p 3 "8 فبراير 2026" "صفحات دليل لينكس 6.18" 
.SH الاسم
log1p, log1pf, log1pl \- لوغاريتم 1 زائد المُعامل
.SH المكتبة
مكتبة الرياضيات (\fIlibm\fP،\ \fI\-lm\fP)
.SH موجز
.nf
\fB#include <math.h>\fP
.P
\fBdouble log1p(double \fP\fIx\fP\fB);\fP
\fBfloat log1pf(float \fP\fIx\fP\fB);\fP
\fBlong double log1pl(long double \fP\fIx\fP\fB);\fP
.P
.fi
.RS -4
متطلبات ماكروات اختبار الميزات لـ glibc (انظر \fBfeature_test_macros\fP(7)):
.RE
.P
.nf
.\"    || _XOPEN_SOURCE && _XOPEN_SOURCE_EXTENDED
\fBlog1p\fP():
    _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L
        || _XOPEN_SOURCE >= 500
        || /* منذ glibc 2.19: */ _DEFAULT_SOURCE
        || /* glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE
.fi
.P
\fBlog1pf\fP(), \fBlog1pl\fP():
.nf
    _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L
        || /* Since glibc 2.19: */ _DEFAULT_SOURCE
        || /* glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE
.fi
.SH الوصف
تعيد هذه الدوال قيمة مكافئة لـ
.P
.in +4n
.EX
log(1 + \f[I]x\fR)
.EE
.in
.P
تُحسب النتيجة بطريقة دقيقة حتى لو كانت قيمة \fIx\fP قريبة من الصفر.
.SH "قيمة الإرجاع"
عند النجاح، تُرجع هذه الدوال اللوغاريتم الطبيعي لـ \fI(1\ +\ x)\fP.
.P
إذا كانت \fIx\fP ليست رقماً (NaN)، فسيُعاد NaN.
.P
إذا كانت \fIx\fP لانهاية موجبة، فستُعاد لانهاية موجبة.
.P
إذا كان \fIx\fP يساوي \-1، يحدث خطأ قطبي، وتُرجع الدوال \-\fBHUGE_VAL\fP أو
\-\fBHUGE_VALF\fP أو \-\fBHUGE_VALL\fP، على التوالي.
.P
.\" POSIX.1 specifies a possible range error if x is subnormal
.\" glibc 2.8 doesn't do this
إذا كان \fIx\fP أقل من \-1 (بما في ذلك اللانهاية السالبة)، يحدث خطأ نطاق، وتُعاد
قيمة NaN (ليس رقمًا).
.SH الأخطاء
انظر \fBmath_error\fP(7) لمعلومات حول كيفية تحديد ما إذا كان قد حدث خطأ عند
استدعاء هذه الدوال.
.P
الأخطاء التالية يمكن أن تحدث:
.TP 
خطأ نطاق: \f[I]x\fR أقل من \-1.
يُضبط \fIerrno\fP على \fBEDOM\fP (لكن راجع BUGS). ويُثار استثناء نقطة عائمة غير
صالح (\fBFE_INVALID\fP).
.TP 
خطأ قطبي: \f[I]x\fR يساوي \-1.
يُضبط \fIerrno\fP على \fBERANGE\fP (لكن راجع BUGS). ويُثار استثناء نقطة عائمة
للقسمة على صفر (\fBFE_DIVBYZERO\fP).
.SH السمات
للاطلاع على شرح للمصطلحات المستخدمة في هذا القسم، انظر \fBattributes\fP(7).
.TS
allbox;
lbx lb lb
l l l.
الواجهة	السمة	القيمة
T{
.na
.nh
\fBlog1p\fP(),
\fBlog1pf\fP(),
\fBlog1pl\fP()
T}	سلامة الخيوط	MT\-Safe
.TE
.SH المعايير
C11, POSIX.1\-2008.
.SH التاريخ
.\" BSD
C99، POSIX.1\-2001.
.SH العلل
.\" https://www.sourceware.org/bugzilla/show_bug.cgi?id=6792
قبل glibc 2.22، لم يقم تنفيذ glibc بضبط \fIerrno\fP على \fBEDOM\fP عند حدوث خطأ في
النطاق.
.P
.\" https://www.sourceware.org/bugzilla/show_bug.cgi?id=6792
قبل glibc 2.22، لم يضبط تطبيق glibc \fIerrno\fP على \fBERANGE\fP عند حدوث خطأ
نطاق.
.SH "انظر أيضًا"
\fBexp\fP(3), \fBexpm1\fP(3), \fBlog\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 .