atan2(3)

الاسم
atan2, atan2f, atan2l - دالة ظل قوسي لمتغيرين

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

موجز
#include <math.h>

double atan2(double y, double x);
float atan2f(float y, float x);
long double atan2l(long double y, long double x);

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

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

الوصف
تحسب هذه الدوال القيمة الرئيسية لظل القوس لـ y/x، باستخدام إشارتي الوسيطتين لتحديد ربع النتيجة.

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

إذا كان y هو +0 (-0) و x أقل من 0، يُرجع +pi (-pi).

إذا كان y هو +0 (-0) و x أكبر من 0، يُرجع +0 (-0).

إذا كان y أقل من 0 و x هو +0 أو -0، يُرجع -pi/2.

إذا كان y أكبر من 0 و x هو +0 أو -0، يُرجع pi/2.

إذا كان أي من x أو y هو NaN، يُرجع NaN.

إذا كان y هو +0 (-0) و x هو -0، يُرجع +pi (-pi).

إذا كان y هو +0 (-0) و x هو +0، يُرجع +0 (-0).

إذا كان y قيمة منتهية أكبر (أقل) من 0، و x هو سالب لانهاية، يُرجع +pi (-pi).

إذا كان y قيمة منتهية أكبر (أقل) من 0، و x هو موجب لانهاية، يُرجع +0 (-0).

إذا كان y موجب لانهاية (سالب لانهاية)، و x منتهٍ، يُرجع pi/2 (-pi/2).

إذا كان y موجب لانهاية (سالب لانهاية) و x سالب لانهاية، يُرجع +3*pi/4 (-3*pi/4).

إذا كان y موجب لانهاية (سالب لانهاية) و x موجب لانهاية، يُرجع +pi/4 (-pi/4).

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

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

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

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

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

انظر أيضًا
acos(3), asin(3), atan(3), carg(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.