scalbn, scalbnf, scalbnl, scalbln, scalblnf, scalblnl

Умножает число с плавающей запятой на целочисленную мощность FLT_RADIX.

Синтаксис

double scalbn(
   double x,
   int exp
);
float scalbn(
   float x,
   int exp
);  // C++ only
long double scalbn(
   long double x,
   int exp
);  // C++ only
float scalbnf(
   float x,
   int exp
);
long double scalbnl(
   long double x,
   int exp
);

#define scalbn(X, INT) // Requires C11 or higher

double scalbln(
   double x,
   long exp
);

float scalblnf(
   float x,
   long exp
);
long double scalblnl(
   long double x,
   long exp
);

#define scalbln(X, LONG) // Requires C11 or higher

float scalbln(
   float x,
   long exp
);  // C++ only
long double scalbln(
   long double x,
   long exp
);  // C++ only

Параметры

x
Значение с плавающей запятой.

exp
Целый показатель степени.

Возвращаемое значение

Функции scalbn возвращают значение x * FLT_RADIX^exp в случае успешного выполнения. При переполнении x(в зависимости от знака), scalbn возвращается +/- HUGE_VAL; errno значение задается ERANGE.

Дополнительные сведения о значениях возврата ошибок см. в errno разделе errno, _doserrnoи _sys_errlist_sys_nerr.

Замечания

FLT_RADIXопределяется в float.h> как <собственный радикс с плавающей запятой; в двоичных системах он имеет значение 2 и scalbn эквивалентенldexp.

Так как C++ разрешает перегрузку, можно вызывать scalbn и scalbln перегрузки, которые принимают и возвращают float или long double типы. В программе C, если вы не используете <макрос tgmath.h> для вызова этой функции, scalbn всегда принимает double и int возвращает и возвращает double, и scalbln всегда принимает double и long возвращает .double

Если вы используете <tgmath.h>scalbn() или scalbln макросы, тип аргумента определяет, какая версия функции выбрана. Дополнительные сведения см . в разделе "Математика с универсальным типом".

По умолчанию глобальное состояние этой функции ограничивается приложением. Чтобы изменить это поведение, см . статью "Глобальное состояние" в CRT.

Требования

Функция	Заголовок C	Заголовок C++
scalbn, scalbnf, scalbnl, scalbln, scalblnf, scalblnl	<math.h>	<cmath>
scalbn или scalbln макрос	<tgmath.h>

Дополнительные сведения о совместимости см. в разделе Совместимость.

Пример

// crt_scalbn.c
// Compile using: cl /W4 crt_scalbn.c
#include <math.h>
#include <stdio.h>

int main( void )
{
   double x = 6.4, y;
   int p = 3;

   y = scalbn( x, p );
   printf( "%2.1f times FLT_RADIX to the power of %d is %2.1f\n", x, p, y );
}

Выходные данные

6.4 times FLT_RADIX to the power of 3 is 51.2

См. также

Поддержка математических и плавающих точек
frexp
ldexp
modf, modff, modfl