RationalNumber

java.lang.Object

|---java.lang.Number

|---|---ohos.utils.RationalNumber

public final class RationalNumber
extends Number
implements Comparable<RationalNumber>

表示有理数的不可变类。

构造函数摘要

构造函数	描述
RationalNumber(int numerator, int denominator)	用于创建具有给定分子和分母的 RationalNumber 实例的构造函数。

方法总结

修饰符和类型	方法	描述
int	compareTo(RationalNumber another)	将当前 RationalNumber 对象与给定对象进行比较。
static RationalNumber	createRationalFromString(String rationalString)	基于给定字符串创建 RationalNumber 对象。
double	doubleValue()	以双精度浮点数的形式获取当前 RationalNumber 对象的值。
boolean	equals(Object obj)	检查给定对象是否与当前 RationalNumber 对象相同。
float	floatValue()	获取当前 RationalNumber 对象的值作为浮点数。
static int	getCommonDivisor(int number1, int number2)	获得两个指定数的最大公约数。
int	getDenominator()	获取当前 RationalNumber 对象的分母。
int	getNumerator()	获取当前 RationalNumber 对象的分子。
int	hashCode()	获取当前 RationalNumber 对象的哈希码值。
int	intValue()	以整数形式获取当前 RationalNumber 对象的值。
boolean	isFinite()	检查当前 RationalNumber 对象是否表示有限值。
boolean	isInfinite()	检查当前 RationalNumber 对象是否表示无限值。
boolean	isNaN()	检查当前 RationalNumber 对象是否表示非数字 (NaN) 值。
boolean	isZero()	检查当前 RationalNumber 对象是否表示值 0。
long	longValue()	以长整数形式获取当前 RationalNumber 对象的值。
String	toString()	获取当前 RationalNumber 对象的字符串表示形式。

从类 java.lang.Number 继承的方法
byteValue, shortValue

从类 java.lang.Object 继承的方法
clone, finalize, getClass, notify, notifyAll, wait, wait, wait

构造函数详细信息

RationalNumber

public RationalNumber(int numerator, int denominator)

用于创建具有给定分子和分母的 RationalNumber 实例的构造函数。

参数：

参数名称	参数描述
numerator	表示分子。
denominator	表示分母。

方法详情

getCommonDivisor

public static int getCommonDivisor(int number1, int number2)

获得两个指定数的最大公约数。

参数：

参数名称	参数描述
number1	表示第一个数字。
number2	表示第二个数字。

返回:

返回两个给定数字的最大公约数。

Throws:

Throw名称	Throw描述
IllegalArgumentException	如果指定的 number1 或 number2 为 Integer#MIN_VALUE，则引发此异常。

equals

public boolean equals(Object obj)

检查给定对象是否与当前 RationalNumber 对象相同。

覆盖：

类 Object 中的等于

参数：

参数名称	参数描述
obj	表示要比较的对象。

返回:

如果给定对象与当前对象相同，则返回 true； 否则返回 false。

hashCode

public int hashCode()

获取当前 RationalNumber 对象的哈希码值。

覆盖：

类 Object 中的 hashCode

返回:

返回当前 RationalNumber 对象的哈希码值。

toString

public String toString()

获取当前 RationalNumber 对象的字符串表示形式。

覆盖：

类 Object 中的 toString

返回:

根据以下规则返回特定字符串：

• 如果当前对象的分子和分母都是0，则返回NaN；
• 如果分母为 0 且分子为正数，则返回 PositiveInfinity；
• 如果分母为 0 且分子为负数，则返回 NegativeInfinity；
• 在其他情况下，返回格式为分子/分母的字符串，例如 3/5。

doubleValue

public double doubleValue()

以双精度浮点数的形式获取当前 RationalNumber 对象的值。

指定者：

类 Number 中的 doubleValue

返回:

返回双精度浮点数。

floatValue

public float floatValue()

获取当前 RationalNumber 对象的值作为浮点数。

指定者：

类 Number 中的 floatValue

返回:

返回浮点数。

intValue

public int intValue()

以整数形式获取当前 RationalNumber 对象的值。

指定者：

类 Number 中的 intValue

返回:

返回整数。

longValue

public long longValue()

以长整数形式获取当前 RationalNumber 对象的值。

指定者：

类 Number 中的 longValue

返回:

返回长整数。

getDenominator

public int getDenominator()

获取当前 RationalNumber 对象的分母。

返回:

返回当前对象的分母。

getNumerator

public int getNumerator()

获取当前 RationalNumber 对象的分子。

返回:

返回当前对象的分子。

isFinite

public boolean isFinite()

检查当前 RationalNumber 对象是否表示有限值。

返回:

如果分母不为 0，则返回 true； 否则返回 false。

isInfinite

public boolean isInfinite()

检查当前 RationalNumber 对象是否表示无限值。

返回:

如果分母为 0 且分子不为 0，则返回 true； 否则返回 false。

isNaN

public boolean isNaN()

检查当前 RationalNumber 对象是否表示非数字 (NaN) 值。

返回:

如果分母和分子都为 0，则返回 true； 否则返回 false。

isZero

public boolean isZero()

检查当前 RationalNumber 对象是否表示值 0。

返回:

如果当前对象表示的值为0，则返回true； 否则返回 false。

createRationalFromString

public static RationalNumber createRationalFromString(String rationalString) throws NumberFormatException

基于给定字符串创建 RationalNumber 对象。

给定的字符串必须采用分子/分母格式，例如 3/5。 要创建表示 NaN 值的对象，请将 NaN 传递给此方法。 要创建一个表示正无穷大值的对象，请传递 PositiveInfinity。 要创建表示负无穷大值的对象，请传递 NegativeInfinity。

参数：

参数名称	参数描述
rationalString	指示用于创建 RationalNumber 对象的字符串。

返回:

返回基于给定字符串生成的 RationalNumber 对象。

Throws:

Throw名称	Throw描述
NullPointerException	如果rationalString 为空，则抛出此异常。
NumberFormatException	如果rationalString 非法，则抛出此异常。

compareTo

public int compareTo(RationalNumber another)

将当前 RationalNumber 对象与给定对象进行比较。

指定者：

接口 ComparableRationalNumber 中的 compareTo

参数：

参数名称	参数描述
another	表示要比较的对象。

返回:

如果两个对象相等则返回 0； 如果给定对象小于当前对象，则返回 1； 如果给定对象大于当前对象，则返回 -1。

Throws:

Throw名称	Throw描述
NullPointerException	如果另一个为空，则抛出此异常。