sin, sinf, sinl

[تعديل] المعطيات

[تعديل] القيمة المُرجعة

في حالة النجاح, تُرجع جيب الزاوية ‎arg‎ ويكون الناتج في الفترة [-1 ; +1].

لو كان هناك خطأ في المجال يتم إرجاع قيمة تحددها البيئة (غالبا NaN على الأنظمة الداعمة لذلك). لو كان هناك خطأ في المدى نتيجة الطفح لأسفل (Underflow) يتم إرجاع القيمة الصحيحة بعد التقريب.

[تعديل] التعامل مع الأخطاء

يتم الإبلاغ عن الأخطاء كما هو موضح في math_errhandling.

إذا كانت البيئة تدعم حسابات الفاصلة العائمة طبقا للـ IEEE (المعيار IEC 60559 تحديدا):

• لو كان المعطى ±0 يتم إرجاعه دون تعديل
• لو كان المعطى ±∞ يتم إرجاع NaN ورفع الإشارة FE_INVALID‎
• لو كان المعطى NaN يتم إرجاع NaN

[تعديل] ملحوظات

لا يحدد المعيار سلوك حال كون الزاوية لا نهائية. POSIX على النقيض تعتبره خطأ في المجال.

[تعديل] مثال

#include <stdio.h>
#include <math.h>
#include <errno.h>
#include <fenv.h>
 
#pragma STDC FENV_ACCESS ON
int main(void)
{
    double pi = acos(-1);
    // typical usage
    printf("sin(pi/6) = %f\n", sin(pi/6));
    printf("sin(pi/2) = %f\n", sin(pi/2));
    printf("sin(-3*pi/4) = %f\n", sin(-3*pi/4));
    // special values
    printf("sin(+0) = %f\n", sin(0.0));
    printf("sin(-0) = %f\n", sin(-0.0));
    // error handling 
    feclearexcept(FE_ALL_EXCEPT);
    printf("sin(INFINITY) = %f\n", sin(INFINITY));
    if(fetestexcept(FE_INVALID)) puts("    FE_INVALID raised");
}

sin(pi/6) = 0.500000
sin(pi/2) = 1.000000
sin(-3*pi/4) = -0.707107
sin(+0) = 0.000000
sin(-0) = -0.000000
sin(INFINITY) = -nan
    FE_INVALID raised

[تعديل] أنظر أيضا