core.math

Встроенные математические функции

Источник

core/math.d

Лицензия:

Лицензия Boost 1.0.

Авторы:

Уолтер Брайт, Дон Клугстон

nothrow @nogc @safe real rndtonl(real x);

Возвращает x, округлённое до целого значения типа long, используя режим округления FE_TONEAREST. Если целое значение x больше long.max, результат неопределён.

pure nothrow @nogc @safe float cos(float x);

pure nothrow @nogc @safe double cos(double x);

pure nothrow @nogc @safe real cos(real x);

Возвращает косинус x. x в радианах.

Специальные значения

x	cos(x)	ошибка?
NAN	NAN	да
±∞	NAN	да

Ошибки:

Результаты неопределены, если |x| >= 2⁶⁴.

pure nothrow @nogc @safe float sin(float x);

pure nothrow @nogc @safe double sin(double x);

pure nothrow @nogc @safe real sin(real x);

Возвращает синус x. x в радианах.

Специальные значения

x	sin(x)	ошибка?
NAN	NAN	да
±0.0	±0.0	нет
±∞	NAN	да

Ошибки:

Результаты неопределены, если |x| >= 2⁶⁴.

pure nothrow @nogc @safe long rndtol(float x);

pure nothrow @nogc @safe long rndtol(double x);

pure nothrow @nogc @safe long rndtol(real x);

Возвращает x, округлённое до целого значения типа long, используя текущий режим округления. Если целое значение x больше long.max, результат неопределён.

pure nothrow @nogc @safe float sqrt(float x);

pure nothrow @nogc @safe double sqrt(double x);

pure nothrow @nogc @safe real sqrt(real x);

Вычислить квадратный корень из x.

Специальные значения

x	sqrt(x)	ошибка?
-0.0	-0.0	нет
<0.0	NAN	да
+∞	+∞	нет

pure nothrow @nogc @safe float ldexp(float n, int exp);

pure nothrow @nogc @safe double ldexp(double n, int exp);

pure nothrow @nogc @safe real ldexp(real n, int exp);

Вычислить n * 2^exp

Ссылки

frexp

pure nothrow @nogc @safe float fabs(float x);

Вычислить абсолютное значение.

Специальные значения

x	fabs(x)
±0.0	+0.0
±∞	+∞

Реализовано как встроенная функция компилятора.

Параметры:

float x

значение с плавающей точкой

Возвращает:

|x|

Ссылки

эквивалентно std.math.fabs

pure nothrow @nogc @safe double fabs(double x);

то же самое

Вычислить абсолютное значение.

Специальные значения

x	fabs(x)
±0.0	+0.0
±∞	+∞

Реализовано как встроенная функция компилятора.

Параметры:

double x

значение с плавающей точкой

Возвращает:

|x|

Ссылки

эквивалентно std.math.fabs

pure nothrow @nogc @safe real fabs(real x);

то же самое

Вычислить абсолютное значение.

Специальные значения

x	fabs(x)
±0.0	+0.0
±∞	+∞

Реализовано как встроенная функция компилятора.

Параметры:

real x

значение с плавающей точкой

Возвращает:

|x|

Ссылки

эквивалентно std.math.fabs

pure nothrow @nogc @safe float rint(float x);

pure nothrow @nogc @safe double rint(double x);

pure nothrow @nogc @safe real rint(real x);

Округляет x до ближайшего целого значения, используя текущий режим округления. Если возвращаемое значение не равно x, генерируется исключение FE_INEXACT. nearbyint выполняет ту же операцию, но не устанавливает исключение FE_INEXACT.

pure nothrow @nogc @safe float yl2x(float x, float y);

pure nothrow @nogc @safe double yl2x(double x, double y);

pure nothrow @nogc @safe real yl2x(real x, real y);

pure nothrow @nogc @safe double yl2xp1(double x, double y);

pure nothrow @nogc @safe real yl2xp1(real x, real y);

Функции-строительные блоки, они переводятся в одну инструкцию x87.

T toPrec(T : float)(float f);

T toPrec(T : float)(double f);

T toPrec(T : float)(real f);

T toPrec(T : double)(float f);

T toPrec(T : double)(double f);

T toPrec(T : double)(real f);

T toPrec(T : real)(float f);

T toPrec(T : real)(double f);

T toPrec(T : real)(real f);

Округление аргумента до заданной точности.

Типы D языка указывают только минимальную точность, а не максимальную. Функция toPrec() принудительно округляет аргумент f до точности указанного типа с плавающей точкой T. Используемый режим округления зависит от платформы, но будет выполнен так, чтобы максимизировать точность. В большинстве случаев по умолчанию используется округление до ближайшего.

Параметры:

T	тип точности для округления
float f	значение для преобразования

Возвращает:

f в точности типа T