.\" -*- coding: UTF-8 -*-
'\" t
.\" Copyright 2004, Andries E. Brouwer <aeb@cwi.nl>
.\" 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 scalbln 3 "8 فبراير 2026" "صفحات دليل لينكس 6.18" 
.SH الاسم
scalbn, scalbnf, scalbnl, scalbln, scalblnf, scalblnl \- توسيع بقوة صحيحة
للأساس
.SH المكتبة
مكتبة الرياضيات (\fIlibm\fP،\ \fI\-lm\fP)
.SH موجز
.nf
\fB#include <math.h>\fP
.P
\fBdouble scalbln(double \fP\fIx\fP\fB, long \fP\fIe\fP\fB);\fP
\fBfloat scalblnf(float \fP\fIx\fP\fB, long \fP\fIe\fP\fB);\fP
\fBlong double scalblnl(long double \fP\fIx\fP\fB, long \fP\fIe\fP\fB);\fP
.P
\fBdouble scalbn(double \fP\fIx\fP\fB, int \fP\fIe\fP\fB);\fP
\fBfloat scalbnf(float \fP\fIx\fP\fB, int \fP\fIe\fP\fB);\fP
\fBlong double scalbnl(long double \fP\fIx\fP\fB, int \fP\fIe\fP\fB);\fP
.fi
.P
.RS -4
متطلبات ماكروات اختبار الميزات لـ glibc (انظر \fBfeature_test_macros\fP(7)):
.RE
.P
\fBscalbln\fP(), \fBscalblnf\fP(), \fBscalblnl\fP():
.nf
    _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L
        || /* Since glibc 2.19: */ _DEFAULT_SOURCE
.fi
.P
\fBscalbn\fP(), \fBscalbnf\fP(), \fBscalbnl\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 في \fBFLT_RADIX\fP (على الأرجح 2) مرفوعًا
للقوة \fIe\fP، أي:
.P
.nf
    x * FLT_RADIX ** e
.fi
.P
.\" not in /usr/include but in a gcc lib
يمكن الحصول على تعريف \fBFLT_RADIX\fP عبر تضمين \fI<float.h>\fP.
.SH "قيمة الإرجاع"
عند النجاح، تعيد هذه الدوال \fIx\fP * \fBFLT_RADIX\fP ** \fIe\fP.
.P
إذا كانت \fIx\fP ليست رقماً (NaN)، فسيُعاد NaN.
.P
إذا كانت \fIx\fP لانهاية موجبة (لانهاية سالبة)، فستُعاد لانهاية موجبة (لانهاية
سالبة).
.P
إذا كانت \fIx\fP هي +0 (\-0)، فُيعاد +0 (\-0).
.P
إذا فاضت النتيجة، يحدث خطأ في النطاق، وتعيد الدوال \fBHUGE_VAL\fP، أو
\fBHUGE_VALF\fP، أو \fBHUGE_VALL\fP على التوالي، مع إشارة مماثلة لـ \fIx\fP.
.P
إذا نقصت النتيجة عن أدنى قيمة (underflow)، يحدث خطأ في النطاق، وتعيد الدوال
صفراً، بنفس إشارة \fIx\fP.
.SH الأخطاء
انظر \fBmath_error\fP(7) لمعلومات حول كيفية تحديد ما إذا كان قد حدث خطأ عند
استدعاء هذه الدوال.
.P
الأخطاء التالية يمكن أن تحدث:
.TP 
خطأ في النطاق، فيض
.\" .I errno
.\" is set to
.\" .BR ERANGE .
يُثار استثناء طفح النقطة العائمة (\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
\fBscalbn\fP(),
\fBscalbnf\fP(),
\fBscalbnl\fP(),
\fBscalbln\fP(),
\fBscalblnf\fP(),
\fBscalblnl\fP()
T}	سلامة الخيوط	MT\-Safe
.TE
.SH المعايير
C11, POSIX.1\-2008.
.SH التاريخ
glibc 2.1.  C99، POSIX.1\-2001.
.SH التاريخ
تختلف هذه الدوال عن الدوال المهملة الموصوفة في \fBscalb\fP(3) في نوع معاملها
الثاني. الدوال الموصوفة في هذه الصفحة لها معامل ثانٍ من نوع صحيح، بينما تلك
الموجودة في \fBscalb\fP(3) لها معامل ثانٍ من النوع \fIdouble\fP.
.SH ملاحظات
إذا كان \fBFLT_RADIX\fP يساوي 2 (وهو المعتاد)، فإن \fBscalbn\fP() يعادل
\fBldexp\fP(3).
.SH العلل
.\" https://www.sourceware.org/bugzilla/show_bug.cgi?id=6803
قبل glibc 2.20، لم تضبط هذه الدوال \fIerrno\fP لأخطاء النطاق.
.SH "انظر أيضًا"
\fBldexp\fP(3), \fBscalb\fP(3)
.PP
.SH ترجمة
تُرجمت هذه الصفحة من الدليل بواسطة
زايد السعيدي <zayed.alsaidi@gmail.com>
.
.PP
هذه الترجمة هي وثيقة مجانية؛ راجع
.UR https://www.gnu.org/licenses/gpl-3.0.html 
رخصة جنو العامة الإصدار 3
.UE
أو ما بعده للاطلاع على شروط حقوق النشر.
لا توجد أي ضمانات.
.PP
إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه،
يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين:
.MT kde-l10n-ar@kde.org
.ME .