- unstable 4.31.0-1
| y0(3) | Library Functions Manual | 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);
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 |
المعايير¶
التاريخ¶
العلل¶
قبل glibc 2.19، شخصّصت هذه الدوال أخطاء القطب بشكل خاطئ: وُضع errno إلى EDOM بدلاً من ERANGE ولم يُثر أي استثناء FE_DIVBYZERO.
قبل glibc 2.17، لم تضبط errno لـ"خطأ النطاق: نتيجة تحت التدفق".
في glibc 2.3.2 والإصدارات الأقدم، لا تثير هذه الدوال استثناء النقطة العائمة غير الصالح (FE_INVALID) عند حدوث خطأ نطاق.
انظر أيضًا¶
ترجمة¶
تُرجمت هذه الصفحة من الدليل بواسطة زايد السعيدي <zayed.alsaidi@gmail.com>
هذه الترجمة هي وثيقة مجانية؛ راجع رخصة جنو العامة الإصدار 3 أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات.
إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه، يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين: kde-l10n-ar@kde.org.
| 8 فبراير 2026 | صفحات دليل لينكس 6.18 |