Scroll to navigation

log(3) Library Functions Manual log(3)

الاسم

log, logf, logl - دالة اللوغاريتم الطبيعي

المكتبة

مكتبة الرياضيات (libm، -lm)

موجز

#include <math.h>
double log(double x);
float logf(float x);
long double logl(long double x);

متطلبات ماكروات اختبار الميزات لـ glibc (انظر feature_test_macros(7)):

logf()، logl():


_ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L
|| /* Since glibc 2.19: */ _DEFAULT_SOURCE
|| /* glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE

الوصف

ترجع هذه الدوال اللوغاريتم الطبيعي لـ x.

قيمة الإرجاع

عند النجاح، ترجع هذه الدوال اللوغاريتم الطبيعي لـ x.

إذا كانت x ليست رقماً (NaN)، فسيُعاد NaN.

إذا كان x يساوي 1، تكون النتيجة +0.

إذا كانت x لانهاية موجبة، فستُعاد لانهاية موجبة.

إذا كان x صفرا، يحدث خطأ قطبي (pole error)، وتعيد الدوال -HUGE_VAL أو -HUGE_VALF أو -HUGE_VALL على التوالي.

إذا كان x سالبًا (بما في ذلك اللانهاية السالبة)، يحدث خطأ نطاق، ويُرجَع NaN (ليس رقمًا).

الأخطاء

انظر math_error(7) لمعلومات حول كيفية تحديد ما إذا كان قد حدث خطأ عند استدعاء هذه الدوال.

الأخطاء التالية يمكن أن تحدث:

خطأ في النطاق: x سالب
تُضبط errno على EDOM. وُيرفع استثناء نقطة عائمة غير صالح (FE_INVALID).
خطأ قطب: x يساوي صفرًا
ضُبط errno على ERANGE. رُفع استثناء نقطة عائمة للقسمة على صفر (FE_DIVBYZERO).

السمات

للاطلاع على شرح للمصطلحات المستخدمة في هذا القسم، انظر attributes(7).

الواجهة السمة القيمة
log()، logf()، logl() سلامة الخيوط MT-Safe

المعايير

C11, POSIX.1-2008.

التاريخ

C99، POSIX.1-2001.

النسخة التي تُعيد double تتوافق أيضًا مع SVr4، و 4.3BSD، و C89.

العلل

في glibc 2.5 والإصدارات الأقدم، يُنتج أخذ log() لـ NaN استثناء عائمًا غير صالح وهميًا (FE_INVALID).

انظر أيضًا

cbrt(3)، clog(3)، log10(3)، log1p(3)، log2(3)، sqrt(3)

ترجمة

تُرجمت هذه الصفحة من الدليل بواسطة زايد السعيدي <zayed.alsaidi@gmail.com>

هذه الترجمة هي وثيقة مجانية؛ راجع رخصة جنو العامة الإصدار 3 أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات.

إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه، يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين: kde-l10n-ar@kde.org.

8 فبراير 2026 صفحات دليل لينكس 6.18