.\" -*- coding: UTF-8 -*- '\" t .\" Copyright 1993, David Metcalfe .\" Copyright, the authors of the Linux man-pages project .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH pow 3 "8 فبراير 2026" "صفحات دليل لينكس 6.18" .SH الاسم pow، powf، powl \- دوال الرفع إلى قوة .SH المكتبة مكتبة الرياضيات (\fIlibm\fP،\ \fI\-lm\fP) .SH موجز .nf \fB#include \fP .P \fBdouble pow(double \fP\fIx\fP\fB, double \fP\fIy\fP\fB);\fP \fBfloat powf(float \fP\fIx\fP\fB, float \fP\fIy\fP\fB);\fP \fBlong double powl(long double \fP\fIx\fP\fB, long double \fP\fIy\fP\fB);\fP .fi .P .RS -4 متطلبات ماكروات اختبار الميزات لـ glibc (انظر \fBfeature_test_macros\fP(7)): .RE .P \fBpowf\fP()، \fBpowl\fP(): .nf _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L || /* Since glibc 2.19: */ _DEFAULT_SOURCE || /* glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE .fi .SH الوصف تُرجع هذه الدوال قيمة \fIx\fP مرفوعة إلى قوة \fIy\fP. .SH "قيمة الإرجاع" عند النجاح، تُرجع هذه الدوال قيمة \fIx\fP إلى قوة \fIy\fP. .P .\" The range error is generated at least as far back as glibc 2.4 إذا فاضت النتيجة، يحدث خطأ نطاق، وتُرجع الدوال \fBHUGE_VAL\fP أو \fBHUGE_VALF\fP أو \fBHUGE_VALL\fP على التوالي، مع الإشارة الصحيحة رياضيًا. .P .\" POSIX.1 does not specify the sign of the zero, .\" but https://www.sourceware.org/bugzilla/show_bug.cgi?id=2678 .\" points out that the zero has the wrong sign in some cases. إذا تدفقت النتيجة تحت المستوى، ولم تكن قابلة للتمثيل، يحدث خطأ نطاق، وتُعاد 0.0 مع الإشارة المناسبة. .P .\" pow(\(+-0, <0 [[odd]]) = HUGE_VAL* إذا كان \fIx\fP هو +0 أو \-0، وكان \fIy\fP عددًا صحيحًا فرديًا أقل من 0، يحدث خطأ قطب وتُعاد \fBHUGE_VAL\fP أو \fBHUGE_VALF\fP أو \fBHUGE_VALL\fP، بنفس إشارة \fIx\fP. .P .\" pow(\(+-0, <0 [[!odd]]) = HUGE_VAL* .\" The pole error is generated at least as far back as glibc 2.4 إذا كان \fIx\fP هو +0 أو \-0، وكان \fIy\fP أقل من 0 وليس عددًا صحيحًا فرديًا، يحدث خطأ قطب وتُعاد +\fBHUGE_VAL\fP أو +\fBHUGE_VALF\fP أو +\fBHUGE_VALL\fP. .P .\" pow(\(+-0, >0 [[odd]]) = \(+-0 إذا كان \fIx\fP هو +0 (\-0)، وكان \fIy\fP عددًا صحيحًا فرديًا أكبر من 0، تكون النتيجة +0 (\-0). .P .\" pow(\(+-0, >0 [[!odd]]) = +0 إذا كان \fIx\fP هو 0، وكان \fIy\fP أكبر من 0 وليس عددًا صحيحًا فرديًا، تكون النتيجة +0. .P .\" pow(-1, \(+-INFINITY) = 1.0 إذا كان \fIx\fP هو \-1، وكان \fIy\fP لا نهاية موجبة أو لا نهاية سالبة، تكون النتيجة 1.0. .P .\" pow(+1, y) = 1.0 إذا كان \fIx\fP هو +1، تكون النتيجة 1.0 (حتى إذا كان \fIy\fP قيمة NaN). .P .\" pow(x, \(+-0) = 1.0 إذا كان \fIy\fP هو 0، تكون النتيجة 1.0 (حتى إذا كان \fIx\fP قيمة NaN). .P .\" pow(<0, y) = NaN .\" The domain error is generated at least as far back as glibc 2.4 إذا كان \fIx\fP قيمة محدودة أقل من 0، وكان \fIy\fP قيمة محدودة غير صحيحة، يحدث خطأ نطاق، وتُعاد قيمة NaN. .P .\" pow(|x|<1, -INFINITY) = INFINITY إذا كانت القيمة المطلقة لـ \fIx\fP أقل من 1، وكان \fIy\fP لا نهاية سالبة، تكون النتيجة لا نهاية موجبة. .P .\" pow(|x|>1, -INFINITY) = +0 إذا كانت القيمة المطلقة لـ \fIx\fP أكبر من 1، وكان \fIy\fP لا نهاية سالبة، تكون النتيجة +0. .P .\" pow(|x|<1, INFINITY) = +0 إذا كانت القيمة المطلقة لـ \fIx\fP أقل من 1، وكان \fIy\fP لا نهاية موجبة، تكون النتيجة +0. .P .\" pow(|x|>1, INFINITY) = INFINITY إذا كانت القيمة المطلقة لـ \fIx\fP أكبر من 1، وكان \fIy\fP لا نهاية موجبة، تكون النتيجة لا نهاية موجبة. .P .\" pow(-INFINITY, <0 [[odd]]) = -0 إذا كان \fIx\fP لا نهاية سالبة، وكان \fIy\fP عددًا صحيحًا فرديًا أقل من 0، تكون النتيجة \-0. .P .\" pow(-INFINITY, <0 [[!odd]]) = +0 إذا كانت \fIx\fP سالبة لانهائية، و \fIy\fP أقل من 0 وليست عددًا صحيحًا فرديًا، تكون النتيجة +0. .P .\" pow(-INFINITY, >0 [[odd]]) = -INFINITY إذا كانت \fIx\fP سالبة لانهائية، و \fIy\fP عددًا صحيحًا فرديًا أكبر من 0، تكون النتيجة سالبة لانهائية. .P .\" pow(-INFINITY, >0 [[!odd]]) = INFINITY إذا كانت \fIx\fP سالبة لانهائية، و \fIy\fP أكبر من 0 وليست عددًا صحيحًا فرديًا، تكون النتيجة موجبة لانهائية. .P .\" pow(INFINITY, <0) = +0 إذا كانت \fIx\fP موجبة لانهائية، و \fIy\fP أقل من 0، تكون النتيجة +0. .P .\" pow(INFINITY, >0) = INFINITY إذا كانت \fIx\fP موجبة لانهائية، و \fIy\fP أكبر من 0، تكون النتيجة موجبة لانهائية. .P .\" pow(NaN, y) or pow(x, NaN) = NaN باستثناء ما هو محدد أعلاه، إذا كانت \fIx\fP أو \fIy\fP قيمة NaN، تكون النتيجة NaN. .SH الأخطاء .\" FIXME . review status of this error .\" longstanding bug report for glibc: .\" https://www.sourceware.org/bugzilla/show_bug.cgi?id=369 .\" For negative x, and -large and +large y, glibc 2.8 gives incorrect .\" results .\" pow(-0.5,-DBL_MAX)=nan .\" EDOM FE_INVALID nan; fail-errno fail-except fail-result; .\" FAIL (expected: range-error-overflow (ERANGE, FE_OVERFLOW); +INF) .\" .\" pow(-1.5,-DBL_MAX)=nan .\" EDOM FE_INVALID nan; fail-errno fail-except fail-result; .\" FAIL (expected: range-error-underflow (ERANGE, FE_UNDERFLOW); +0) .\" .\" pow(-0.5,DBL_MAX)=nan .\" EDOM FE_INVALID nan; fail-errno fail-except fail-result; .\" FAIL (expected: range-error-underflow (ERANGE, FE_UNDERFLOW); +0) .\" .\" pow(-1.5,DBL_MAX)=nan .\" EDOM FE_INVALID nan; fail-errno fail-except fail-result; .\" FAIL (expected: range-error-overflow (ERANGE, FE_OVERFLOW); +INF) انظر \fBmath_error\fP(7) لمعلومات حول كيفية تحديد ما إذا كان قد حدث خطأ عند استدعاء هذه الدوال. .P الأخطاء التالية يمكن أن تحدث: .TP خطأ في المجال: \f[I]x\fR سالبة، و \f[I]y\fR عدد محدود غير صحيح تُضبط \fIerrno\fP على \fBEDOM\fP. وُيرفع استثناء نقطة عائمة غير صالح (\fBFE_INVALID\fP). .TP خطأ قطبي: \f[I]x\fR صفر، و \f[I]y\fR سالبة يُضبط \fIerrno\fP على \fBERANGE\fP (لكن راجع BUGS). ويُثار استثناء نقطة عائمة للقسمة على صفر (\fBFE_DIVBYZERO\fP). .TP خطأ في النطاق: النتيجة تفيض تُضبط \fIerrno\fP على \fBERANGE\fP. وُيرفع استثناء تجاوز نقطة عائمة (\fBFE_OVERFLOW\fP). .TP خطأ في النطاق: النتيجة تتدفق سفليًا يُضبط \fIerrno\fP على \fBERANGE\fP. ويُثار استثناء فيض سفلي للنقطة العائمة (\fBFE_UNDERFLOW\fP). .SH السمات للاطلاع على شرح للمصطلحات المستخدمة في هذا القسم، انظر \fBattributes\fP(7). .TS allbox; lbx lb lb l l l. الواجهة السمة القيمة T{ .na .nh \fBpow\fP(), \fBpowf\fP(), \fBpowl\fP() T} سلامة الخيوط MT\-Safe .TE .SH المعايير C11, POSIX.1\-2008. .SH التاريخ C99، POSIX.1\-2001. .P النسخة التي تُعيد \fIdouble\fP تتوافق أيضًا مع SVr4، و 4.3BSD، و C89. .SH العلل .SS "أخطاء تاريخية (وُصلت الآن)" .\" https://sourceware.org/bugzilla/show_bug.cgi?id=13932 .\" commit c3d466cba1692708a19c6ff829d0386c83a0c6e5 قبل glibc 2.28، على بعض البنى (مثل x86\-64)، قد تكون \fBpow\fP() أبطأ بأكثر من 10,000 مرة لبعض المدخلات مقارنة بمدخلات قريبة أخرى. هذا يؤثر فقط على \fBpow\fP()، وليس على \fBpowf\fP() أو \fBpowl\fP(). وُصلت هذه المشكلة في glibc 2.28. .P .\" https://www.sourceware.org/bugzilla/show_bug.cgi?id=3866 وُصل عدد من الأخطاء في تنفيذ glibc لـ \fBpow\fP() في glibc 2.16. .P .\" .\" https://www.sourceware.org/bugzilla/show_bug.cgi?id=6776 .\" or possibly 2.9, I haven't found the source code change .\" and I don't have a 2.9 system to test في إصدار glibc 2.9 وما قبله، عند حدوث خطأ قطبي (pole error)، يُضبط \fIerrno\fP على \fBEDOM\fP بدلاً من \fBERANGE\fP الذي يفرضه معيار POSIX. ومنذ glibc 2.10، تقوم glibc بالإجراء الصحيح. .P .\" Actually, glibc 2.3.2 is the earliest test result I have; so yet .\" to confirm if this error occurs only in glibc 2.3.2. في glibc 2.3.2 والإصدارات الأقدم، عند حدوث خطأ فيض أو تدفق سفلي، تُولد \fBpow\fP() في glibc استثناء نقطة عائمة غير صالح وهمي (\fBFE_INVALID\fP) بالإضافة إلى استثناء الفيض أو التدفق السفلي. .SH "انظر أيضًا" \fBcbrt\fP(3)، \fBcpow\fP(3)، \fBsqrt\fP(3) .PP .SH ترجمة تُرجمت هذه الصفحة من الدليل بواسطة زايد السعيدي . .PP هذه الترجمة هي وثيقة مجانية؛ راجع .UR https://www.gnu.org/licenses/gpl-3.0.html رخصة جنو العامة الإصدار 3 .UE أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات. .PP إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه، يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين: .MT kde-l10n-ar@kde.org .ME .