ceil(3)

الاسم
ceil, ceilf, ceill - دالة السقف: أصغر قيمة صحيحة لا تقل عن الوسيط

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

موجز
#include <math.h>

double ceil(double x);
float ceilf(float x);
long double ceill(long double x);

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

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

الوصف
ترجع هذه الدوال أصغر قيمة صحيحة لا تقل عن x.

على سبيل المثال، ceil(0.5) هي 1.0، و ceil(-0.5) هي 0.0.

قيمة الإرجاع
ترجع هذه الدوال سقف x.

إذا كانت x عددًا صحيحًا، أو +0، أو -0، أو NaN، أو لا نهائية، تُعاد x نفسها.

الأخطاء
لم تحدث أخطاء.

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

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

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

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

يحتوي SUSv2 و POSIX.1-2001 على نص حول الطفح (الذي قد يضبط errno على ERANGE، أو يرفع استثناء FE_OVERFLOW). عمليًا، لا يمكن أن تطفح النتيجة على أي آلة حالية، لذا فإن مسألة معالجة الأخطاء هذه كانت مجرد هراء. (بشكل أدق، يمكن أن يحدث الطفح فقط عندما تكون القيمة القصوى للأس أصغر من عدد بتات الجزء الكسري. بالنسبة لأرقام الفاصلة العائمة بمعيار IEEE-754 ذات 32 بت و 64 بت، تكون القيمة القصوى للأس هي 127 (على التوالي، 1023)، وعدد بتات الجزء الكسري بما في ذلك البت الضمني هو 24 (على التوالي، 53)). أُزيل هذا في POSIX.1-2008.

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

انظر أيضًا
floor(3), lrint(3), nearbyint(3), rint(3), round(3), trunc(3)

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

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

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