ilogb(3)

الاسم
ilogb, ilogbf, ilogbl - الحصول على الأس الصحيح لقيمة فاصلة عائمة

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

موجز
#include <math.h>

int ilogb(double x);
int ilogbf(float x);
int ilogbl(long double x);

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

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

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

الوصف
تُرجع هذه الدوال جزء الأس من معاملها كعدد صحيح مُشار إليه. عندما لا يحدث خطأ، تكون هذه الدوال مكافئة لدوال logb(3) المقابلة، مع تحويل النوع إلى int.

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

إذا كان x صفرًا، يحدث خطأ نطاق، وتُرجع الدوال FP_ILOGB0.

إذا كان x قيمة NaN، يحدث خطأ نطاق، وتُرجع الدوال FP_ILOGBNAN.

إذا كان x سالب ما لا نهاية أو موجب ما لا نهاية، يحدث خطأ نطاق، وتُرجع الدوال INT_MAX.

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

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

خطأ نطاق: x هو 0 أو قيمة NaN
    يُثار استثناء فاصلة عائمة غير صالح (FE_INVALID)، ويُضبط errno إلى EDOM (لكن انظر الأخطاء).

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

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

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

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

العلل
قبل glibc 2.16، وُجدت الأخطاء التالية في تطبيق glibc لهذه الدوال:

•   حالة خطأ النطاق حيث x هو 0 أو قيمة NaN لم تتسبب في ضبط errno أو (على بعض البنى) إثارة استثناء فاصلة عائمة.

•   حالة خطأ النطاق حيث x هو ما لا نهاية لم تتسبب في ضبط errno أو إثارة استثناء فاصلة عائمة.

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

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

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

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