y0(3)

الاسم
y0, y0f, y0l, y1, y1f, y1l, yn, ynf, ynl - دوال بيسل من النوع الثاني

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

موجز
#include <math.h>

double y0(double x);
double y1(double x);
double yn(int n, double x);

float y0f(float x);
float y1f(float x);
float ynf(int n, float x);

long double y0l(long double x);
long double y1l(long double x);
long double ynl(int n, long double x);

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

y0(), y1(), yn():
    _XOPEN_SOURCE
        || /* منذ glibc 2.19: */ _DEFAULT_SOURCE
        || /* glibc <= 2.19: */ _SVID_SOURCE || _BSD_SOURCE

y0f(), y0l(), y1f(), y1l(), ynf(), ynl():
    _XOPEN_SOURCE >= 600
        || (_ISOC99_SOURCE && _XOPEN_SOURCE)
        || /* منذ glibc 2.19: */ _DEFAULT_SOURCE
        || /* glibc <= 2.19: */ _SVID_SOURCE || _BSD_SOURCE

الوصف
ترجع الدالتان y0() و y1() دوال بيسل من النوع الثاني لـ x من الرتبتين 0 و 1 على التوالي. ترجع الدالة yn() دالة بيسل من النوع الثاني لـ x من الرتبة n.

يجب أن تكون قيمة x موجبة.

الدوال y0f() و y1f() و ynf() هي إصدارات تأخذ وترجع قيمًا من النوع float. الدوال y0l() و y1l() و ynl() هي إصدارات تأخذ وترجع قيمًا من النوع long double.

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

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

إذا كانت x سالبة، يحدث خطأ نطاق، وترجع الدوال -HUGE_VAL أو -HUGE_VALF أو -HUGE_VALL على التوالي. (يسمح POSIX.1-2001 أيضًا بإرجاع NaN لهذه الحالة.)

إذا كانت x تساوي 0.0، يحدث خطأ قطبي، وترجع الدوال -HUGE_VAL أو -HUGE_VALF أو -HUGE_VALL على التوالي.

إذا كان الناتج أقل من الحد الأدنى، يحدث خطأ نطاق، وترجع الدوال 0.0

إذا كان الناتج تجاوزًا، يحدث خطأ نطاق، وترجع الدوال -HUGE_VAL أو -HUGE_VALF أو -HUGE_VALL على التوالي. (يسمح POSIX.1-2001 أيضًا بإرجاع 0.0 لهذه الحالة.)

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

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

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

خطأ قطبي: x يساوي 0.0
    يُضبط errno إلى ERANGE ويُثار استثناء FE_DIVBYZERO (لكن انظر الأخطاء).

خطأ في النطاق: فيض تحتي في النتيجة
    يُضبط errno إلى ERANGE. لا يُرجع استثناء FE_UNDERFLOW بواسطة fetestexcept(3) لهذه الحالة.

خطأ في النطاق: طفح في النتيجة
    ضُبط errno على ERANGE (لكن انظر قسم الأخطاء BUGS). رُفع استثناء نقطة عائمة لتجاوز السعة (FE_OVERFLOW).

السمات
للاطلاع على شرح للمصطلحات المستخدمة في هذا القسم، انظر attributes(7).
الواجهة | السمة | القيمة
y0()، y0f()، y0l() | سلامة الخيوط | MT-Safe
y1()، y1f()، y1l() | سلامة الخيوط | MT-Safe
yn()، ynf()، ynl() | سلامة الخيوط | MT-Safe

المعايير

y0()
y1()
yn()
    POSIX.1-2008.

أخرى:
    BSD.

التاريخ

y0()
y1()
yn()
    SVr4، 4.3BSD، POSIX.1-2001.

أخرى:
    BSD.

العلل
قبل glibc 2.19، شخصّصت هذه الدوال أخطاء القطب بشكل خاطئ: وُضع errno إلى EDOM بدلاً من ERANGE ولم يُثر أي استثناء FE_DIVBYZERO.

قبل glibc 2.17، لم تضبط errno لـ"خطأ النطاق: نتيجة تحت التدفق".

في glibc 2.3.2 والإصدارات الأقدم، لا تثير هذه الدوال استثناء النقطة العائمة غير الصالح (FE_INVALID) عند حدوث خطأ نطاق.

انظر أيضًا
j0(3)

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

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

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