math_isRelativelyClose

指定した2つの値が互いに相対的に近似しているどうかを表す値を取得します。

taiseiue | 2024-05-02
  • 共有
  •  記事の編集

定義

名前空間: Alice.Math
アセンブリ: Losetta.Runtime.dll
ソースコード: Alice.Math.cs

math_isRelativelyClose(number,number,number)

指定した2つの値が互いに相対的に近似しているどうかを表す値を取得します。

AliceScript
namespace Alice.IO;
public bool math_isRelativelyClose(number x, number y, number tolerance = 1E-9) requires(tolerance > 0);
引数
x 比較する一方の値
y 比較するもう一方の値
tolerance xとyのうち絶対値の大きいほうの値に対して許容される最大誤差。既定値は1E-9です。この値は0より大きい必要があります。
戻り値
bool xとyが互いに近似している場合はtrue、それ以外の場合はfalse

対応
AliceScript 4
AliceSister 4
Losetta 0.11

説明

この関数は、以下の表に従ってxとyが一定の許容誤差以内で近似しているかを調べます。 toleranceは、xとyの絶対値の大きい方に対するxとyの最大許容誤差です。 たとえば、最大許容誤差を5%にする場合は0.05に設定します。また、xとyが少なくとも5桁等しいことを確認するには、1E-5を指定します。規定では、9桁等しいことを確認します。

条件 結果
\(x=\)NaNまたは\(y=\)NaN 等しくない(false)
\(x=\pm\infty\)かつ\(y\neq\pm\infty\) 等しくない(false)
\(x\neq\pm\infty\)かつ\(y=\pm\infty\) 等しくない(false)
\(x=\pm\infty\)かつ\(y=\pm\infty\) x,yが同符号の場合のみ等しい
\(x=y\) 等しい(true)
\(x>y\) \(x\times tolerance \geq (x - y)\)
\(x<y\) \(y\times tolerance \geq (y - x)\)

ふたつの値の差の絶対値の最大値を決めて近似を判定する場合は、math_isAbsolutelyCloseを使用してください。

例

次の例では、0.1 + 0.1 + 0.1の結果が0.3とは厳密には異なることを確認し、かつ相対的には近いことを確認しています。

AliceScript
using Alice.Math;

number x = 0.1 + 0.1 + 0.1;
number y = 0.3;
print(x == y);//出力:false

print(math_isRelativelyClose(x, y));//出力:true