sincos(3)

الاسم
sincos, sincosf, sincosl - حساب الجيب وجيب التمام في آن واحد

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

موجز
#define _GNU_SOURCE         /* انظر feature_test_macros(7) */
#include <math.h>

void sincos(double x, double *sin, double *cos);
void sincosf(float x, float *sin, float *cos);
void sincosl(long double x, long double *sin, long double *cos);

الوصف
تحتاج عدة تطبيقات إلى جيب وجيب التمام لنفس الزاوية x. تحسب هذه الدوال كليهما في نفس الوقت، وتُخزَّن النتائج في *sin و *cos. قد يكون استخدام هذه الدالة أكثر كفاءة من استدعاءين منفصلين لـ sin(3) و cos(3).

إذا كان x قيمة NaN، تُعاد قيمة NaN في *sin و *cos.

إذا كان x موجب اللانهاية أو سالب اللانهاية، يحدث خطأ نطاق، وتُعاد قيمة NaN في *sin و *cos.

قيمة الإرجاع
تُرجع هذه الدوال void.

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

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

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

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

المعايير
GNU.

التاريخ
glibc 2.1.

ملاحظات
لرؤية ميزة الأداء لـ sincos()، قد يكون من الضروري تعطيل التحسينات المضمنة في gcc(1)، باستخدام معاملات مثل:

    cc -O -lm -fno-builtin prog.c

العلل
قبل glibc 2.22، لم يقم تنفيذ glibc بضبط errno على EDOM عند حدوث خطأ في النطاق.

انظر أيضًا
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.