logb(3)

الاسم
logb, logbf, logbl - الحصول على أس قيمة فاصلة عائمة

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

موجز
#include <math.h>

double logb(double x);
float logbf(float x);
long double logbl(long double x);

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

logb():
    _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L
        || _XOPEN_SOURCE >= 500
        || /* منذ glibc 2.19: */ _DEFAULT_SOURCE
        || /* glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE

logbf(), logbl():
    _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L
        || /* Since glibc 2.19: */ _DEFAULT_SOURCE
        || /* glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE

الوصف
تستخرج هذه الدوال الأس من التمثيل الداخلي للفاصلة العائمة لـ x وتُرجعه كقيمة فاصلة عائمة. يشير الثابت الصحيح FLT_RADIX، المُعرَّف في <float.h>، إلى الأساس المُستخدم لتمثيل الفاصلة العائمة للنظام. إذا كان FLT_RADIX يساوي 2، فإن logb(x) مشابه لـ floor(log2(fabs(x))), باستثناء أن الأخير قد يُعطي عددًا صحيحًا غير صحيح بسبب التقريب الوسيط.

إذا كان x دون معياري، تُرجع logb() الأس الذي كان سيكون لـ x لو كان مُعياريًا.

قيمة الإرجاع
عند النجاح، تُرجع هذه الدوال أس x.

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

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

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

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

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

خطأ قطبي: x يساوي 0
    يُثار استثناء فاصلة عائمة للقسمة على صفر (FE_DIVBYZERO).

هذه الدوال لا تضبط errno.

السمات
للاطلاع على شرح للمصطلحات المستخدمة في هذا القسم، انظر attributes(7).
الواجهة | السمة | القيمة
logb(), logbf(), logbl() | سلامة الخيوط | MT-Safe

المعايير
C11, POSIX.1-2008.

التاريخ
C99، POSIX.1-2001.

logb()
    4.3BSD (انظر IEEE.3 في دليل 4.3BSD).

انظر أيضًا
ilogb(3), log(3)

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

هذه الترجمة هي وثيقة مجانية؛ راجع رخصة جنو العامة الإصدار 3 (https://www.gnu.org/licenses/gpl-3.0.html) أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات.

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