pow, powf, powl

 

C

اللغة

الملفات الرأسية

الأنواع الأساسية

الإدارة الديناميكية للذاكرة

معالجة الأخطاء

أدوات إدارة البرنامج

الوقت والتاريخ

مكتبةالسلاسل النصية

الخوارزميات

معالجة الأعداد

الإدخال والإخراج

الإعدادات المحلية

مسارات التنفيذ (C11)

العمليات الذرية (C11)

المقترحات غير المعتمدة

 

الأعداد

دوال رياضية شائعة

بيئة الفاصلة العائمة

حساب الأعداد المركبة

توليد أعداد عشوائية

دوال رياضية عامة النوع

 

دوال رياضية شائعة

الدوال
عمليات بسيطة
abslabsllabsimaxabs (C99) fabs divldivlldivimaxdiv (C99) fmod	remainder (C99) remquo (C99) fma (C99) fmax (C99) fmin (C99) fdim (C99) nannanfnanl (C99)(C99)(C99)
دوال أسية ولوغارتمية ثابتة الأساس
exp exp2 (C99) expm1 (C99)	log log10 log1p (C99) log2 (C99)
دوال أسية وجذور
sqrt cbrt (C99)	hypot (C99) pow
دوال حساب المثلثات والدول الزائدية
sin cos tan asin acos atan atan2	sinh cosh tanh asinh (C99) acosh (C99) atanh (C99)
دالة الخطأ ودالة غاوس
erf (C99) erfc (C99)	lgamma (C99) tgamma (C99)
إيجاد أقرب عدد صحيح لفاصلة عائمة (float)
ceil floor roundlroundllround (C99)(C99)(C99)	trunc (C99) nearbyint (C99) rintlrintllrint (C99)(C99)(C99)
دوال التعديل على الفاصلة العائمة (float)
ldexp scalbnscalbln (C99)(C99) ilogb (C99) logb (C99)	frexp modf nextafternexttoward (C99)(C99) copysign (C99)
التصنيف والمقارنة
fpclassify (C99) isfinite (C99) isinf (C99) isnan (C99) isnormal (C99) signbit (C99)	isgreater (C99) isgreaterequal (C99) isless (C99) islessequal (C99) islessgreater (C99) isunordered (C99)
ثوابت ماكرو
HUGE_VALFHUGE_VALHUGE_VALL (C99)(C99)	FP_NORMALFP_SUBNORMALFP_ZEROFP_INFINITEFP_NAN (C99)(C99)(C99)(C99)(C99)

 

معرفة في ملف <math.h>
float powf( float base, float exponent );	(1)	(منذ C99)
double pow( double base, double exponent );	(2)
long double powl( long double base, long double exponent );	(3)	(منذ C99)
معرفة في ملف <tgmath.h>
#define pow( base, exponent )	(4)	(منذ C99)

1-3) تحسب قيمة رفع العدد ‎base‎ للأس ‎exponent‎.

4) ماكرو عام النوع: إذا كان المعطى من النوع long double يتم استدعاء ‎powl‎. أما إذا كان المعطى عدد صحيح أو من النوع double يتم استدعاء ‎pow‎. فيما عدا ذلك يتم استدعاء ‎powf‎. إذا كان المعطى عددا مركبا يتم استدعاء الدالة المركبة المناسبة (cpowf أو cpow أو cpowl).

المعطيات

base	-	الأساس كعدد ذو فاصلة عائمة
exponent	-	الأس كعدد ذو فاصلة عائمة

القيمة المُرجعة

مالم يحدث خطأ يتم إرجاع ‎base‎ مرفوعة لأس ‎exponent‎ ‏‎.(baseexponent
)‎

لو كان هناك خطأ في المجال يتم إرجاع قيمة تحددها البيئة (NaN على الأنظمة الداعمة لذلك). لو كان هناك خطأ قطبي أو في المدى نتيجة الطفح (Overflow) يتم إرجاع ‎±HUGE_VAL‎ أو ‎±HUGE_VALF‎, أو ‎±HUGE_VALL‎.

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

التعامل مع الأخطاء

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

ملحوظات

بينما لا يمكن حساب الجذر لعدد سالب عن طريق ‎pow‎ يمكن استخدام cbrt‎ في حالة أن الأس هو 1/3.

مثال

قم بتشغيل هذا الكود:

#include <stdio.h>
#include <math.h>
#include <errno.h>
#include <fenv.h>
 
#pragma STDC FENV_ACCESS ON
int main(void)
{
    // الاستخدام المعتاد
    printf("pow(2, 10) = %f\n", pow(2,10));
    printf("pow(2, 0.5) = %f\n", pow(2,0.5));
    printf("pow(-2, -3) = %f\n", pow(-2,-3));
    // قيم خاصة
    printf("pow(-1, NAN) = %f\n", pow(-1,NAN));
    printf("pow(+1, NAN) = %f\n", pow(+1,NAN));
    printf("pow(INFINITY, 2) = %f\n", pow(INFINITY, 2));
    printf("pow(INFINITY, -1) = %f\n", pow(INFINITY, -1));
    // التعامل مع الأخطاء 
    errno = 0; feclearexcept(FE_ALL_EXCEPT);
    printf("pow(-1, 1/3) = %f\n", pow(-1, 1.0/3));
    if(errno == EDOM)         perror("    errno == EDOM");
    if(fetestexcept(FE_INVALID)) puts("    FE_INVALID raised");
 
    feclearexcept(FE_ALL_EXCEPT);
    printf("pow(-0, -3) = %f\n", pow(-0.0, -3));
    if(fetestexcept(FE_DIVBYZERO)) puts("    FE_DIVBYZERO raised");
}

خرج ممكن:

pow(2, 10) = 1024.000000
pow(2, 0.5) = 1.414214
pow(-2, -3) = -0.125000
pow(-1, NAN) = nan
pow(+1, NAN) = 1.000000
pow(INFINITY, 2) = inf
pow(INFINITY, -1) = 0.000000
pow(-1, 1/3) = -nan
    errno == EDOM: Numerical argument out of domain
    FE_INVALID raised
pow(-0, -3) = -inf
    FE_DIVBYZERO raised

أنظر أيضا

sqrtsqrtfsqrtl (C99)(C99)	تحسب الجذر التربيعي (‎√x‎) (دالة)
cbrtcbrtfcbrtl (C99)(C99)(C99)	تحسب الجذر التكعيبي (‎3√x) (دالة)
hypothypotfhypotl (C99)(C99)(C99)	تحسب الجذر التربيعي لمجمع مربعي عددين معينين ‎ (√x2 +y2 )‎ (دالة)
cpowcpowfcpowl (C99)(C99)(C99)	computes the complex power function (دالة)
مقالة مرجع C++‎ عن pow