鸿蒙OS HalfFloat

HalfFloat

java.lang.Object

|---java.lang.Number

|---|---ohos.utils.HalfFloat

public class HalfFloat
extends Number

封装半精度浮点格式的数据。

​

方法总结

修饰符和类型	方法	描述
byte	byteValue()	以字节形式返回指定数字的值，可能涉及舍入或截断。
double	doubleValue()	以 double 形式返回指定数字的值，这可能涉及舍入。
boolean	equals(Object obj)	指示其他对象是否“等于”这个对象。
float	floatValue()	将指定数字的值作为浮点数返回，这可能涉及舍入。
int	hashCode()	返回对象的哈希码值。
int	intValue()	以 int 形式返回指定数字的值，可能涉及舍入或截断。
long	longValue()	以 long 形式返回指定数字的值，可能涉及舍入或截断。
short	shortValue()	以短整数形式返回指定数字的值，可能涉及舍入或截断。
String	toString()	返回对象的字符串表示形式。
short	value()	获取此 HalfFloat 实例的简短表示。
static HalfFloat	valueOf(float value)	创建一个表示浮点类型的指定值的 HalfFloat 实例。
static HalfFloat	valueOf(short value)	创建一个表示短类型的指定值的 HalfFloat 实例。
static HalfFloat	valueOf(String value)	创建一个表示 String 类型的指定值的 HalfFloat 实例。

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

方法详情

valueOf

public static HalfFloat valueOf(short value)

创建一个表示短类型的指定值的 HalfFloat 实例。

参数：

参数名称	参数描述
value	指示要解析的值的短类型。

返回:

表示指定值的 HalfFloat 实例

valueOf

public static HalfFloat valueOf(float value)

创建一个表示浮点类型的指定值的 HalfFloat 实例。

参数：

参数名称	参数描述
value	指示要解析的值的浮点类型。

返回:

表示指定值的 HalfFloat 实例

valueOf

public static HalfFloat valueOf(String value)

创建一个表示 String 类型的指定值的 HalfFloat 实例。

参数：

参数名称	参数描述
value	指示要解析的值的字符串类型。 value 必须是 Float 类型的 String 表示形式，例如“0.0f”和“4e2f”。

返回:

表示指定值的 HalfFloat 实例

Throws:

Throw名称	Throw描述
NumberFormatException	如果指定的值无法转换为 Float 类型，则引发此异常。
NullPointerException	如果值为 null，则引发此异常。

value

public short value()

获取此 HalfFloat 实例的简短表示。

返回:

返回此 HalfFloat 实例的简短表示。

byteValue

public byte byteValue()

从类复制的描述：数字

以字节形式返回指定数字的值，可能涉及舍入或截断。

此实现将 Number.intValue() 转换为字节的结果返回。

覆盖：

类 Number 中的 byteValue

返回:

此对象在转换为字节类型后表示的数值。

shortValue

public short shortValue()

从类复制的描述：数字

以短整数形式返回指定数字的值，可能涉及舍入或截断。

此实现将 Number.intValue() 的结果返回为一个short。

覆盖：

类 Number 中的 shortValue

返回:

此对象在转换为 short 类型后表示的数值。

intValue

public int intValue()

从类复制的描述：数字

以 int 形式返回指定数字的值，可能涉及舍入或截断。

指定者：

类 Number 中的 intValue

返回:

此对象在转换为 int 类型后表示的数值。

longValue

public long longValue()

从类复制的描述：数字

以 long 形式返回指定数字的值，可能涉及舍入或截断。

指定者：

类 Number 中的 longValue

返回:

此对象在转换为 long 类型后表示的数值。

floatValue

public float floatValue()

从类复制的描述：数字

将指定数字的值作为浮点数返回，这可能涉及舍入。

指定者：

类 Number 中的 floatValue

返回:

此对象在转换为 float 类型后表示的数值。

doubleValue

public double doubleValue()

从类复制的描述：数字

以 double 形式返回指定数字的值，这可能涉及舍入。

指定者：

类 Number 中的 doubleValue

返回:

此对象在转换为 double 类型后表示的数值。

equals

public boolean equals(Object obj)

从类复制的描述：对象

指示其他对象是否“等于”这个对象。

equals 方法在非空对象引用上实现等价关系：

• 它是自反的：对于任何非空引用值 x，x.equals(x) 应该返回 true。
• 它是对称的：对于任何非空引用值 x 和 y，当且仅当 y.equals(x) 返回 true 时，x.equals(y) 才应该返回 true。
• 它是可传递的：对于任何非空引用值 x、y 和 z，如果 x.equals(y) 返回 true 并且 y.equals(z) 返回 true，则 x.equals(z) 应该返回 true。
• 它是一致的：对于任何非空引用值 x 和 y，x.equals(y) 的多次调用始终返回 true 或始终返回 false，前提是没有修改对象上 equals 比较中使用的信息。
• 对于任何非空引用值 x，x.equals(null) 应该返回 false。

Object 类的 equals 方法实现了对象上最有区别的可能等价关系； 也就是说，对于任何非空引用值 x 和 y，当且仅当 x 和 y 引用同一个对象（x == y 的值为 true）时，此方法才返回 true。

请注意，每当重写该方法时，通常都需要重写 hashCode 方法，以维护 hashCode 方法的一般约定，即相等的对象必须具有相等的哈希码。

覆盖：

类 Object 中的等于

参数：

参数名称	参数描述
obj	要与之比较的参考对象。

返回:

如果此对象与 obj 参数相同，则为 true； 否则为 false。

hashCode

public int hashCode()

从类复制的描述：对象

返回对象的哈希码值。 支持这种方法是为了有利于哈希表，例如 HashMap 提供的那些。

hashCode 的一般合约是：

• 每当在 Java 应用程序执行期间对同一对象多次调用时，hashCode 方法必须始终返回相同的整数，前提是没有修改对象上相等比较中使用的信息。 该整数不需要从应用程序的一次执行到同一应用程序的另一次执行保持一致。
• 如果两个对象根据 equals(Object) 方法相等，则对两个对象中的每一个调用 hashCode 方法必须产生相同的整数结果。
• 如果根据 Object.equals(java.lang.Object) 方法，如果两个对象不相等，则不要求对两个对象中的每一个调用 hashCode 方法必须产生不同的整数结果。 但是，程序员应该意识到，为不相等的对象生成不同的整数结果可能会提高哈希表的性能。

在合理可行的情况下，由 Object 类定义的 hashCode 方法确实为不同的对象返回不同的整数。 （这通常通过将对象的内部地址转换为整数来实现，但 Java™ 编程语言不需要这种实现技术。）

覆盖：

类 Object 中的 hashCode

返回:

此对象的哈希码值。

toString

public String toString()

从类复制的描述：对象

返回对象的字符串表示形式。 通常，toString 方法返回一个“以文本方式表示”该对象的字符串。 结果应该是一个简洁但信息丰富的表示，易于人们阅读。 建议所有子类重写此方法。

Object 类的 toString 方法返回一个字符串，该字符串由对象作为其实例的类的名称、at 符号字符“@”和对象哈希码的无符号十六进制表示形式组成。 换句话说，此方法返回一个等于以下值的字符串：

 getClass().getName() + '@' + Integer.toHexString(hashCode()) 

覆盖：

类 Object 中的 toString

返回：

对象的字符串表示形式。