asin(3)

الاسم
asin, asinf, asinl - دالة قوس الجيب

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

موجز
#include <math.h>

double asin(double x);
float asinf(float x);
long double asinl(long double x);

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

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

الوصف
تحسب هذه الدوال القيمة الرئيسية لقوس جيب x؛ أي القيمة التي جيبها هو x.

قيمة الإرجاع
عند النجاح، تُرجع هذه الدوال القيمة الرئيسية لقوس جيب x بالراديان؛ وتكون القيمة المُرجعة في النطاق [-pi/2, pi/2].

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

إذا كانت x هي +0 (-0)، فُيعاد +0 (-0).

إذا كان x خارج النطاق [-1, 1]، يحدث خطأ في النطاق، ويُعاد NaN.

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

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

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

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

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

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

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

انظر أيضًا
acos(3), atan(3), atan2(3), casin(3), cos(3), sin(3), tan(3)

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

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

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