gdドキュメント0.8.0

APIリファレンス

GD.math

数学関数、IEEE 754の特殊な値、浮動小数点数とビット列の変換を扱います。

プロパティ

bits : GD.math.bits

64ビット整数のビット数の計算、回転、反転、桁上がり付きの演算を行います。

e : float
pi : float
phi : float
sqrt2 : float
sqrt_e : float
sqrt_pi : float
sqrt_phi : float
ln2 : float
log2_e : float
ln10 : float
log10_e : float
max_float64 : float
smallest_nonzero_float64 : float

メソッド

abs

abs(x: float) -> float
英語原文

Provide unary mathematical functions.

引数

名前型省略時の値説明
xfloat省略不可数値入力。三角関数の角度入力はラジアン。

戻り値

float

エラー

この関数は、結果とは別にErrを返す形式ではありません。結果の確認方法は、この関数の説明を参照してください。

acos

acos(x: float) -> float
英語原文

Return inverse cosine.

引数

名前型省略時の値説明
xfloat省略不可数値入力。三角関数の角度入力はラジアン。

戻り値

float

エラー

この関数は、結果とは別にErrを返す形式ではありません。結果の確認方法は、この関数の説明を参照してください。

acosh

acosh(x: float) -> float
英語原文

Return inverse hyperbolic cosine.

引数

名前型省略時の値説明
xfloat省略不可数値入力。三角関数の角度入力はラジアン。

戻り値

float

エラー

この関数は、結果とは別にErrを返す形式ではありません。結果の確認方法は、この関数の説明を参照してください。

asin

asin(x: float) -> float
英語原文

Return inverse sine.

引数

名前型省略時の値説明
xfloat省略不可数値入力。三角関数の角度入力はラジアン。

戻り値

float

エラー

この関数は、結果とは別にErrを返す形式ではありません。結果の確認方法は、この関数の説明を参照してください。

asinh

asinh(x: float) -> float
英語原文

Return inverse hyperbolic sine.

引数

名前型省略時の値説明
xfloat省略不可数値入力。三角関数の角度入力はラジアン。

戻り値

float

エラー

この関数は、結果とは別にErrを返す形式ではありません。結果の確認方法は、この関数の説明を参照してください。

atan

atan(x: float) -> float
英語原文

Return inverse tangent.

引数

名前型省略時の値説明
xfloat省略不可数値入力。三角関数の角度入力はラジアン。

戻り値

float

エラー

この関数は、結果とは別にErrを返す形式ではありません。結果の確認方法は、この関数の説明を参照してください。

atanh

atanh(x: float) -> float
英語原文

Return inverse hyperbolic tangent.

引数

名前型省略時の値説明
xfloat省略不可数値入力。三角関数の角度入力はラジアン。

戻り値

float

エラー

この関数は、結果とは別にErrを返す形式ではありません。結果の確認方法は、この関数の説明を参照してください。

cbrt

cbrt(x: float) -> float
英語原文

Return cube root.

引数

名前型省略時の値説明
xfloat省略不可数値入力。三角関数の角度入力はラジアン。

戻り値

float

エラー

この関数は、結果とは別にErrを返す形式ではありません。結果の確認方法は、この関数の説明を参照してください。

ceil

ceil(x: float) -> float
英語原文

Round toward positive infinity.

引数

名前型省略時の値説明
xfloat省略不可数値入力。三角関数の角度入力はラジアン。

戻り値

float

エラー

この関数は、結果とは別にErrを返す形式ではありません。結果の確認方法は、この関数の説明を参照してください。

cos

cos(x: float) -> float
英語原文

Return cosine.

引数

名前型省略時の値説明
xfloat省略不可数値入力。三角関数の角度入力はラジアン。

戻り値

float

エラー

この関数は、結果とは別にErrを返す形式ではありません。結果の確認方法は、この関数の説明を参照してください。

cosh

cosh(x: float) -> float
英語原文

Return hyperbolic cosine.

引数

名前型省略時の値説明
xfloat省略不可数値入力。三角関数の角度入力はラジアン。

戻り値

float

エラー

この関数は、結果とは別にErrを返す形式ではありません。結果の確認方法は、この関数の説明を参照してください。

erf

erf(x: float) -> float
英語原文

Return the error function.

引数

名前型省略時の値説明
xfloat省略不可数値入力。三角関数の角度入力はラジアン。

戻り値

float

エラー

この関数は、結果とは別にErrを返す形式ではありません。結果の確認方法は、この関数の説明を参照してください。

erfc

erfc(x: float) -> float
英語原文

Return the complementary error function.

引数

名前型省略時の値説明
xfloat省略不可数値入力。三角関数の角度入力はラジアン。

戻り値

float

エラー

この関数は、結果とは別にErrを返す形式ではありません。結果の確認方法は、この関数の説明を参照してください。

erfinv

erfinv(x: float) -> float
英語原文

Return inverse error function.

引数

名前型省略時の値説明
xfloat省略不可数値入力。三角関数の角度入力はラジアン。

戻り値

float

エラー

この関数は、結果とは別にErrを返す形式ではありません。結果の確認方法は、この関数の説明を参照してください。

erfcinv

erfcinv(x: float) -> float
英語原文

Return inverse complementary error function.

引数

名前型省略時の値説明
xfloat省略不可数値入力。三角関数の角度入力はラジアン。

戻り値

float

エラー

この関数は、結果とは別にErrを返す形式ではありません。結果の確認方法は、この関数の説明を参照してください。

exp

exp(x: float) -> float
英語原文

Return the natural exponential.

引数

名前型省略時の値説明
xfloat省略不可数値入力。三角関数の角度入力はラジアン。

戻り値

float

エラー

この関数は、結果とは別にErrを返す形式ではありません。結果の確認方法は、この関数の説明を参照してください。

exp2

exp2(x: float) -> float
英語原文

Return the base-two exponential.

引数

名前型省略時の値説明
xfloat省略不可数値入力。三角関数の角度入力はラジアン。

戻り値

float

エラー

この関数は、結果とは別にErrを返す形式ではありません。結果の確認方法は、この関数の説明を参照してください。

expm1

expm1(x: float) -> float
英語原文

Return the natural exponential minus one.

引数

名前型省略時の値説明
xfloat省略不可数値入力。三角関数の角度入力はラジアン。

戻り値

float

エラー

この関数は、結果とは別にErrを返す形式ではありません。結果の確認方法は、この関数の説明を参照してください。

floor

floor(x: float) -> float
英語原文

Round toward negative infinity.

引数

名前型省略時の値説明
xfloat省略不可数値入力。三角関数の角度入力はラジアン。

戻り値

float

エラー

この関数は、結果とは別にErrを返す形式ではありません。結果の確認方法は、この関数の説明を参照してください。

gamma

gamma(x: float) -> float
英語原文

Return the Gamma function.

引数

名前型省略時の値説明
xfloat省略不可数値入力。三角関数の角度入力はラジアン。

戻り値

float

エラー

この関数は、結果とは別にErrを返す形式ではありません。結果の確認方法は、この関数の説明を参照してください。

ilogb

ilogb(x: float) -> int
英語原文

Return the binary exponent as an integer.

引数

名前型省略時の値説明
xfloat省略不可数値入力。三角関数の角度入力はラジアン。

戻り値

int

エラー

この関数は、結果とは別にErrを返す形式ではありません。結果の確認方法は、この関数の説明を参照してください。

j0

j0(x: float) -> float
英語原文

Normalize platform C-math Bessel functions to the public contract.

引数

名前型省略時の値説明
xfloat省略不可数値入力。三角関数の角度入力はラジアン。

戻り値

float

エラー

この関数は、結果とは別にErrを返す形式ではありません。結果の確認方法は、この関数の説明を参照してください。

j1

j1(x: float) -> float
英語原文

Return the first-kind Bessel function of order one.

引数

名前型省略時の値説明
xfloat省略不可数値入力。三角関数の角度入力はラジアン。

戻り値

float

エラー

この関数は、結果とは別にErrを返す形式ではありません。結果の確認方法は、この関数の説明を参照してください。

log

log(x: float) -> float
英語原文

Return the natural logarithm.

引数

名前型省略時の値説明
xfloat省略不可数値入力。三角関数の角度入力はラジアン。

戻り値

float

エラー

この関数は、結果とは別にErrを返す形式ではありません。結果の確認方法は、この関数の説明を参照してください。

log1p

log1p(x: float) -> float
英語原文

Return the natural logarithm of one plus the input.

引数

名前型省略時の値説明
xfloat省略不可数値入力。三角関数の角度入力はラジアン。

戻り値

float

エラー

この関数は、結果とは別にErrを返す形式ではありません。結果の確認方法は、この関数の説明を参照してください。

log2

log2(x: float) -> float
英語原文

Return the base-two logarithm.

引数

名前型省略時の値説明
xfloat省略不可数値入力。三角関数の角度入力はラジアン。

戻り値

float

エラー

この関数は、結果とは別にErrを返す形式ではありません。結果の確認方法は、この関数の説明を参照してください。

log10

log10(x: float) -> float
英語原文

Return the base-ten logarithm.

引数

名前型省略時の値説明
xfloat省略不可数値入力。三角関数の角度入力はラジアン。

戻り値

float

エラー

この関数は、結果とは別にErrを返す形式ではありません。結果の確認方法は、この関数の説明を参照してください。

logb

logb(x: float) -> float
英語原文

Return the binary exponent as a floating-point value.

引数

名前型省略時の値説明
xfloat省略不可数値入力。三角関数の角度入力はラジアン。

戻り値

float

エラー

この関数は、結果とは別にErrを返す形式ではありません。結果の確認方法は、この関数の説明を参照してください。

round

round(x: float) -> float
英語原文

Round to the nearest integer with ties away from zero.

引数

名前型省略時の値説明
xfloat省略不可数値入力。三角関数の角度入力はラジアン。

戻り値

float

エラー

この関数は、結果とは別にErrを返す形式ではありません。結果の確認方法は、この関数の説明を参照してください。

round_to_even

round_to_even(x: float) -> float
英語原文

Round ties to even, preserving signed zero and large integral values.

引数

名前型省略時の値説明
xfloat省略不可数値入力。三角関数の角度入力はラジアン。

戻り値

float

エラー

この関数は、結果とは別にErrを返す形式ではありません。結果の確認方法は、この関数の説明を参照してください。

signbit

signbit(x: float) -> bool
英語原文

Report whether the sign bit is set.

引数

名前型省略時の値説明
xfloat省略不可数値入力。三角関数の角度入力はラジアン。

戻り値

bool

エラー

この関数は、結果とは別にErrを返す形式ではありません。結果の確認方法は、この関数の説明を参照してください。

sin

sin(x: float) -> float
英語原文

Return sine.

引数

名前型省略時の値説明
xfloat省略不可数値入力。三角関数の角度入力はラジアン。

戻り値

float

エラー

この関数は、結果とは別にErrを返す形式ではありません。結果の確認方法は、この関数の説明を参照してください。

sinh

sinh(x: float) -> float
英語原文

Return hyperbolic sine.

引数

名前型省略時の値説明
xfloat省略不可数値入力。三角関数の角度入力はラジアン。

戻り値

float

エラー

この関数は、結果とは別にErrを返す形式ではありません。結果の確認方法は、この関数の説明を参照してください。

sqrt

sqrt(x: float) -> float
英語原文

Return square root.

引数

名前型省略時の値説明
xfloat省略不可数値入力。三角関数の角度入力はラジアン。

戻り値

float

エラー

この関数は、結果とは別にErrを返す形式ではありません。結果の確認方法は、この関数の説明を参照してください。

tan

tan(x: float) -> float
英語原文

Return tangent.

引数

名前型省略時の値説明
xfloat省略不可数値入力。三角関数の角度入力はラジアン。

戻り値

float

エラー

この関数は、結果とは別にErrを返す形式ではありません。結果の確認方法は、この関数の説明を参照してください。

tanh

tanh(x: float) -> float
英語原文

Return hyperbolic tangent.

引数

名前型省略時の値説明
xfloat省略不可数値入力。三角関数の角度入力はラジアン。

戻り値

float

エラー

この関数は、結果とは別にErrを返す形式ではありません。結果の確認方法は、この関数の説明を参照してください。

trunc

trunc(x: float) -> float
英語原文

Truncate the fractional part toward zero.

引数

名前型省略時の値説明
xfloat省略不可数値入力。三角関数の角度入力はラジアン。

戻り値

float

エラー

この関数は、結果とは別にErrを返す形式ではありません。結果の確認方法は、この関数の説明を参照してください。

y0

y0(x: float) -> float
英語原文

Return the second-kind Bessel function of order zero.

引数

名前型省略時の値説明
xfloat省略不可数値入力。三角関数の角度入力はラジアン。

戻り値

float

エラー

この関数は、結果とは別にErrを返す形式ではありません。結果の確認方法は、この関数の説明を参照してください。

y1

y1(x: float) -> float
英語原文

Return the second-kind Bessel function of order one.

引数

名前型省略時の値説明
xfloat省略不可数値入力。三角関数の角度入力はラジアン。

戻り値

float

エラー

この関数は、結果とは別にErrを返す形式ではありません。結果の確認方法は、この関数の説明を参照してください。

float64_bits

float64_bits(x: float) -> int
英語原文

Convert between floating-point values and IEEE 754 integer bit patterns.

引数

名前型省略時の値説明
xfloat省略不可数値入力。三角関数の角度入力はラジアン。

戻り値

int

エラー

この関数は、結果とは別にErrを返す形式ではありません。結果の確認方法は、この関数の説明を参照してください。

float64_from_bits

float64_from_bits(x: int) -> float
英語原文

Construct a double from its bit pattern.

引数

名前型省略時の値説明
xint省略不可再解釈する64ビットのIEEE 754表現を保持する整数。

戻り値

float

エラー

この関数は、結果とは別にErrを返す形式ではありません。結果の確認方法は、この関数の説明を参照してください。

float32_bits

float32_bits(x: float) -> int
英語原文

Return the bit pattern after rounding to single precision.

引数

名前型省略時の値説明
xfloat省略不可数値入力。三角関数の角度入力はラジアン。

戻り値

int

エラー

この関数は、結果とは別にErrを返す形式ではありません。結果の確認方法は、この関数の説明を参照してください。

float32_from_bits

float32_from_bits(x: int) -> float
英語原文

Construct a single-precision value from its bit pattern.

引数

名前型省略時の値説明
xint省略不可再解釈する32ビットのIEEE 754表現を保持する整数。

戻り値

float

エラー

この関数は、結果とは別にErrを返す形式ではありません。結果の確認方法は、この関数の説明を参照してください。

nan

nan() -> float
英語原文

Return NaN.

引数

引数はありません。

戻り値

float

エラー

この関数は、結果とは別にErrを返す形式ではありません。結果の確認方法は、この関数の説明を参照してください。

inf

inf(sign: int) -> float
英語原文

Return infinity with the selected sign.

引数

名前型省略時の値説明
signint省略不可符号の選択値、または符号のコピー元となる値。

戻り値

float

エラー

この関数は、結果とは別にErrを返す形式ではありません。結果の確認方法は、この関数の説明を参照してください。

is_inf

is_inf(x: float, sign: int = 0) -> bool
英語原文

Check for infinity with the selected sign.

引数

名前型省略時の値説明
xfloat省略不可数値入力。三角関数の角度入力はラジアン。
signint0符号の選択値、または符号のコピー元となる値。

戻り値

bool

エラー

この関数は、結果とは別にErrを返す形式ではありません。結果の確認方法は、この関数の説明を参照してください。

is_nan

is_nan(x: float) -> bool
英語原文

Check for NaN.

引数

名前型省略時の値説明
xfloat省略不可数値入力。三角関数の角度入力はラジアン。

戻り値

bool

エラー

この関数は、結果とは別にErrを返す形式ではありません。結果の確認方法は、この関数の説明を参照してください。

atan2

atan2(y: float, x: float) -> float
英語原文

Provide functions using two or more values.

引数

名前型省略時の値説明
yfloat省略不可計算に使う2つ目の数値。atan2では縦座標。
xfloat省略不可横座標。yと組み合わせて象限を決めます。

戻り値

float

エラー

この関数は、結果とは別にErrを返す形式ではありません。結果の確認方法は、この関数の説明を参照してください。

copysign

copysign(value: float, sign: float) -> float
英語原文

Combine one value's magnitude with another's sign.

引数

名前型省略時の値説明
valuefloat省略不可保存、変換、検査など、この関数で処理する値。
signfloat省略不可符号の選択値、または符号のコピー元となる値。

戻り値

float

エラー

この関数は、結果とは別にErrを返す形式ではありません。結果の確認方法は、この関数の説明を参照してください。

dim

dim(x: float, y: float) -> float
英語原文

Return the positive difference of two values.

引数

名前型省略時の値説明
xfloat省略不可数値入力。三角関数の角度入力はラジアン。
yfloat省略不可計算に使う2つ目の数値。atan2では縦座標。

戻り値

float

エラー

この関数は、結果とは別にErrを返す形式ではありません。結果の確認方法は、この関数の説明を参照してください。

fma

fma(x: float, y: float, z: float) -> float
英語原文

Return a fused multiply-add with one rounding.

引数

名前型省略時の値説明
xfloat省略不可数値入力。三角関数の角度入力はラジアン。
yfloat省略不可計算に使う2つ目の数値。atan2では縦座標。
zfloat省略不可fmaの乗算結果に加える値。

戻り値

float

エラー

この関数は、結果とは別にErrを返す形式ではありません。結果の確認方法は、この関数の説明を参照してください。

hypot

hypot(x: float, y: float) -> float
英語原文

Return the hypotenuse length.

引数

名前型省略時の値説明
xfloat省略不可数値入力。三角関数の角度入力はラジアン。
yfloat省略不可計算に使う2つ目の数値。atan2では縦座標。

戻り値

float

エラー

この関数は、結果とは別にErrを返す形式ではありません。結果の確認方法は、この関数の説明を参照してください。

ldexp

ldexp(frac: float, exp: int) -> float
英語原文

Scale a fraction by a power of two.

引数

名前型省略時の値説明
fracfloat省略不可2の累乗で拡大・縮小する仮数部分。
expint省略不可仮数の拡大・縮小に使う2の整数指数。

戻り値

float

エラー

この関数は、結果とは別にErrを返す形式ではありません。結果の確認方法は、この関数の説明を参照してください。

max

max(x: float, y: float) -> float
英語原文

Select the maximum with explicit NaN and signed-zero handling.

引数

名前型省略時の値説明
xfloat省略不可数値入力。三角関数の角度入力はラジアン。
yfloat省略不可計算に使う2つ目の数値。atan2では縦座標。

戻り値

float

エラー

この関数は、結果とは別にErrを返す形式ではありません。結果の確認方法は、この関数の説明を参照してください。

min

min(x: float, y: float) -> float
英語原文

Select the minimum with explicit NaN and signed-zero handling.

引数

名前型省略時の値説明
xfloat省略不可数値入力。三角関数の角度入力はラジアン。
yfloat省略不可計算に使う2つ目の数値。atan2では縦座標。

戻り値

float

エラー

この関数は、結果とは別にErrを返す形式ではありません。結果の確認方法は、この関数の説明を参照してください。

mod

mod(x: float, y: float) -> float
英語原文

Return the remainder after truncated division.

引数

名前型省略時の値説明
xfloat省略不可数値入力。三角関数の角度入力はラジアン。
yfloat省略不可計算に使う2つ目の数値。atan2では縦座標。

戻り値

float

エラー

この関数は、結果とは別にErrを返す形式ではありません。結果の確認方法は、この関数の説明を参照してください。

nextafter

nextafter(x: float, y: float) -> float
英語原文

Return the adjacent representable value toward the target.

引数

名前型省略時の値説明
xfloat省略不可数値入力。三角関数の角度入力はラジアン。
yfloat省略不可計算に使う2つ目の数値。atan2では縦座標。

戻り値

float

エラー

この関数は、結果とは別にErrを返す形式ではありません。結果の確認方法は、この関数の説明を参照してください。

nextafter32

nextafter32(x: float, y: float) -> float
英語原文

Return the adjacent single-precision value toward the target.

引数

名前型省略時の値説明
xfloat省略不可数値入力。三角関数の角度入力はラジアン。
yfloat省略不可計算に使う2つ目の数値。atan2では縦座標。

戻り値

float

エラー

この関数は、結果とは別にErrを返す形式ではありません。結果の確認方法は、この関数の説明を参照してください。

pow

pow(x: float, y: float) -> float
英語原文

Return a power.

引数

名前型省略時の値説明
xfloat省略不可数値入力。三角関数の角度入力はラジアン。
yfloat省略不可計算に使う2つ目の数値。atan2では縦座標。

戻り値

float

エラー

この関数は、結果とは別にErrを返す形式ではありません。結果の確認方法は、この関数の説明を参照してください。

pow10

pow10(n: int) -> float
英語原文

Return ten raised to an integral power.

引数

名前型省略時の値説明
nint省略不可10のn乗を求める整数指数。

戻り値

float

エラー

この関数は、結果とは別にErrを返す形式ではありません。結果の確認方法は、この関数の説明を参照してください。

remainder

remainder(x: float, y: float) -> float
英語原文

Return the remainder using the nearest integral quotient.

引数

名前型省略時の値説明
xfloat省略不可数値入力。三角関数の角度入力はラジアン。
yfloat省略不可計算に使う2つ目の数値。atan2では縦座標。

戻り値

float

エラー

この関数は、結果とは別にErrを返す形式ではありません。結果の確認方法は、この関数の説明を参照してください。

frexp

frexp(x: float) -> Array
英語原文

Return multiple results in declared order as an Array.

引数

名前型省略時の値説明
xfloat省略不可数値入力。三角関数の角度入力はラジアン。

戻り値

Array

エラー

この関数は、結果とは別にErrを返す形式ではありません。結果の確認方法は、この関数の説明を参照してください。

lgamma

lgamma(x: float) -> Array
英語原文

Return log absolute Gamma and its sign.

引数

名前型省略時の値説明
xfloat省略不可数値入力。三角関数の角度入力はラジアン。

戻り値

Array

エラー

この関数は、結果とは別にErrを返す形式ではありません。結果の確認方法は、この関数の説明を参照してください。

modf

modf(x: float) -> Array
英語原文

Split a value into integral and fractional parts.

引数

名前型省略時の値説明
xfloat省略不可数値入力。三角関数の角度入力はラジアン。

戻り値

Array

エラー

この関数は、結果とは別にErrを返す形式ではありません。結果の確認方法は、この関数の説明を参照してください。

sincos

sincos(x: float) -> Array
英語原文

Return sine and cosine together.

引数

名前型省略時の値説明
xfloat省略不可数値入力。三角関数の角度入力はラジアン。

戻り値

Array

エラー

この関数は、結果とは別にErrを返す形式ではありません。結果の確認方法は、この関数の説明を参照してください。