语言

Half 类

定义

该 Half 类是包装和实用工具类,用于操作半精度 16 位 IEEE 754 浮点数据类型(也称为 fp16 或 binary16)。

[Android.Runtime.Register("android/util/Half", ApiSince=26, DoNotGenerateAcw=true)]
public sealed class Half : Java.Lang.Number, IDisposable, Java.Lang.IComparable
[<Android.Runtime.Register("android/util/Half", ApiSince=26, DoNotGenerateAcw=true)>]
type Half = class
    inherit Number
    interface IComparable
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable
继承
特性
实现

注解

该 Half 类是包装和实用工具类,用于操作半精度 16 位 IEEE 754 浮点数据类型(也称为 fp16 或 binary16)。 可以从单精度浮点数创建或转换为单精度浮点数,并存储在短数据类型中。 若要区分持有半精度浮点数的短值与常规短值,建议使用 @HalfFloat 批注。

IEEE 754 标准将 fp16 指定为具有以下格式:

<ul>li Sign bit: 1 bit/li li><>Exponent width: 5 bits</li li<>>Significand: 10 bits<</li></ul><>

格式如下所述:

1   11111   1111111111
            ^   --^--   -----^----
            sign  |          |_______ significand
                  |
                  -- exponent

与单精度浮点(fp32)相比,半精度浮点可以节省内存和/或带宽,代价是范围和精度。

为了帮助你确定 fp16 是否适合你的存储类型,请参阅下表,其中显示了可能值范围内的可用精度。 精度列指示范围特定部分中两个连续数字之间的步长大小。

<表 summary=“fp16 的精度跨范围”>tr th>Range start</>><th Precision</th></tr><<>><td>0</td><td 1 ⁄ 16,777,216</td></tr><tr><td>>1 ⁄ 16,384</td td>><1 ⁄ 16,777,216</td></tr><<>td>1 ⁄ 8,192</td><td 1 ⁄ 8,388,608</td>></tr tr><<><td>1 ⁄ 4,096</td><td>1 ⁄ 4,194,304</td/tr>><<td><> 1 ⁄ 2,048</td><td td>1 ⁄ 2,097,152</td></tr<>><td td>1 ⁄ 1,024</td td><>1 ⁄ 1,048,576</td/tr<><>td>>< 1 ⁄ 512</td><td 1 ⁄ 524,288</td></tr<>tr><td>>1 ⁄256</td><td>1 ⁄ 262,144</td></tr<>><td>1 ⁄ 128</td><td>1 ⁄ 131,072</td></tr><><td>1 ⁄ 64</td><td>1 ⁄ 65,536</td/tr<><>td>>< 1 ⁄ 32/td><td>1 ⁄ 32,768<</td></tr><tr><td>1 ⁄ 16</td><td 1>⁄16,384</td/tr<><>td>>< 1 ⁄ 8</td><td>1 ⁄ 8,192</td></tr><tr><td>1 ⁄ 4</td><td>1 ⁄ 4,096</td/tr><><td><> 1 ⁄ 2/td><td>1 ⁄ 2,048<</td></tr<>><td>1</td><td>1 ⁄ 1,024</td></tr><tr><td>2</td><td>1 ⁄ 512</td></tr<><>td>4</td><td>1 ⁄ 256</td></tr<><>td>8</td><td>1 ⁄ 128</td></tr<>tr><td>16</td><td>1 ⁄ 64</td></tr><><tr td>32/td><td>1 ⁄ 32<</td></tr><tr><td>64</td><td>1 ⁄ 16</td></tr<>tr><td>128</td td><>1 ⁄ 8</td></tr<><>tr td>256</td><td 1 ⁄ 4</td><><<>/tr td>512</td><td>1 ⁄ 2</><td/tr><><tr td>1,024</td>><td>1</td></tr>><<td>2,048</td><td>2</td></tr<>tr><td>4,096</td td>4</td><></tr><><tr td>8,1 92</td><td>8</td></tr<>tr><td>16,384</td><td>16</td></tr><<>td>32,768</td><td 32</td>></tr></table>

此表显示大于 1024 的数字会丢失所有小数精度。

Java文档android.util.Half。

本页的某些部分是根据 创建和共享的工作进行的修改,并根据 许可证中所述的条款使用。

构造函数

名称 说明
Half(Double)

构造一个新分配 Half 的对象,该对象表示转换为半精度浮点数的参数。

Half(Int16)

构造表示半精度浮点类型参数的新分配 Half 对象。

Half(Single)

构造一个新分配 Half 的对象,该对象表示转换为半精度浮点数的参数。

Half(String)

构造表示字符串所表示的半精度浮点值的新分配 Half 对象。

字段

名称 说明
Epsilon

Epsilon 是 1.0 与由半精度浮点表示的下一个值之间的差异。

LowestValue

半精度浮点数可能具有最小负值。

MaxExponent

有限半精度浮点数的最大指数可能具有。

MaxValue

半精度浮点数的最大正有限值可能具有。

MinExponent

规范化半精度浮点数的最小指数可能具有。

MinNormal

半精度浮点数可能具有最小正正值。

MinValue

半精度浮点数可能具有最小正非零值。

NaN

半精度浮点数的 Not-Number 表示形式。

NegativeInfinity

类型半精度浮点数的负无穷大。

NegativeZero

类型半精度浮点数的负 0。

PositiveInfinity

类型半精度浮点的正无穷大。

PositiveZero

类型半精度浮点数的正 0。

Size

用于表示半精度浮点值的位数。

属性

名称 说明
Class

返回此 Object的运行时类。

(继承自 Object)
Handle

基础 Android 实例的句柄。

(继承自 Object)
IsNaN

如果此值 Half 表示 Not-a-Number,则返回 true;否则返回 false。

JniIdentityHashCode

获取互操作运行时分配给此Java对等的标识哈希代码。

(继承自 Object)
JniManagedPeerState

获取运行时上次分配的状态标志。

(继承自 JavaObject)
JniPeerMembers

获取用于访问此Java绑定成员的 JNI 元数据。

PeerReference

获取此Java对等方的 JNI 对象引用。

(继承自 Object)
ThresholdClass

此 API 支持 Mono for Android 基础结构,不打算直接从代码使用。

(继承自 Number)
ThresholdType

此 API 支持 Mono for Android 基础结构,不打算直接从代码使用。

(继承自 Number)

方法

名称 说明
Abs(Int16)

返回指定半精度浮点数的绝对值。

ByteValue()

返回指定数字的值作为一个 byte。

(继承自 Number)
Ceil(Int16)

返回小于或等于指定半精度浮点值的负无穷大最小半精度浮点值。

Clone()

创建并返回此对象的副本。

(继承自 Object)
Compare(Int16, Int16)

比较两个指定的半精度浮点值。

CompareTo(Half)

比较两个指定的半精度浮点值。

Construct(JniObjectReference, JniObjectReferenceOptions)

将此对等方的构造委托给运行时的值管理器。

(继承自 JavaObject)
CopySign(Int16, Int16)

返回具有第二个参数符号的第一个参数。

Dispose()

释放此Java对等方持有的资源。

(继承自 Object)
Dispose(Boolean)

释放此Java对等方持有的资源。

(继承自 Object)
DisposeUnlessReferenced()

要求值管理器释放此对等方,除非其映射保留此相同的托管实例。

(继承自 JavaObject)
DoubleValue()

以加宽基元转换后的形式Half返回此值double。

Equals(Int16, Int16)

如果两个半精度浮点值相等,则返回 true。

Equals(Object)

测试另一个托管对等方是否引用同一Java对象。

(继承自 JavaObject)
Equals(Object)

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

(继承自 Object)
FloatValue()

以加宽基元转换后的形式Half返回此值float。

Floor(Int16)

返回小于或等于指定半精度浮点值的最大半精度浮点值,以小于或等于正无穷大。

GetExponent(Int16)

返回指定半精度浮点值的表示形式中使用的无偏差指数。

GetHashCode()

返回对象的哈希代码值。

(继承自 Object)
GetSign(Int16)

返回指定半精度浮点数的符号。

GetSignificand(Int16)

返回指定半精度浮点值的表示形式中使用的符号或 mantissa。

Greater(Int16, Int16)

如果上半精度浮点值大于后半精度浮点值(向正无穷大),则返回 true。

GreaterEquals(Int16, Int16)

如果上半精度浮点值大于或等于下半精度浮点值,则返回 true。

HalfToIntBits(Int16)

根据上述 Half位布局返回指定半精度浮点值的表示形式。

HalfToRawIntBits(Int16)

根据上述 Half位布局返回指定半精度浮点值的表示形式。

HalfToShortBits(Int16)

根据上述 Half位布局返回指定半精度浮点值的表示形式。

HalfValue()

返回此 Half 值的半精度值,该值包含 short 上述 Half位表示形式。

HashCode(Int16)

返回半精度浮点值的哈希代码。

IntBitsToHalf(Int32)

返回对应于给定位表示形式的半精度浮点值。

IntValue()

以缩小基元转换后的形式Half返回此值int。

InvokeIsNaN(Int16)

如果指定的半精度浮点值表示 Not-a-Number,则返回 true;否则返回 false。

IsInfinite(Int16)

如果指定的半精度浮点值表示无穷大,则返回 true,否则返回 false。

IsNormalized(Int16)

如果指定的半精度浮点值规范化(没有非正常表示形式),则返回 true。

JavaFinalize()
已过时.

当垃圾回收确定不再引用该对象时,由对象上的垃圾回收器调用。

(继承自 Object)
Less(Int16, Int16)

如果上半精度浮点值小于负无穷大(小于负无穷大),则返回 true。

LessEquals(Int16, Int16)

如果上半精度浮点值小于或等于下半精度浮点值,则返回 true。

LongValue()

以缩小基元转换后的形式Half返回此值long。

Max(Int16, Int16)

返回两个半精度浮点值中的较大值(最接近正无穷大的值)。

Min(Int16, Int16)

返回两个半精度浮点值(最接近负无穷大的值)的较小值。

Notify()

唤醒正在等待此对象的监视器的单个线程。

(继承自 Object)
NotifyAll()

唤醒正在等待此对象的监视器的所有线程。

(继承自 Object)
ParseHalf(String)

返回由指定字符串表示的半精度浮点值。

Round(Int16)

返回最接近指定半精度浮点值的整型半精度浮点值。

SetHandle(IntPtr, JniHandleOwnership)

设置 Handle 属性。

(继承自 Object)
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)

在不创建 JNI 引用副本的情况下,将引用值存储在控制块中。

(继承自 JavaObject)
ShortValue()

返回指定数字的值作为一个 short。

(继承自 Number)
ToArray<T>()

从此Java数组包装器创建托管数组。

(继承自 Object)
ToFloat(Int16)

将指定的半精度浮点值转换为单精度浮点值。

ToHalf(Single)

将指定的单精度浮点值转换为半精度浮点值。

ToHexString(Int16)

返回指定半精度浮点值的十六进制字符串表示形式。

ToString()

返回对象的字符串表示形式。

(继承自 Object)
ToString(Int16)

返回指定半精度浮点值的字符串表示形式。

Trunc(Int16)

返回指定的半精度浮点值的截断的半精度浮点值。

UnregisterFromRuntime()

从互操作运行时取消注册此Java对等。

(继承自 Object)
ValueOf(Int16)

返回一个 Half 表示指定半精度浮点值的实例。

ValueOf(Single)

返回一个 Half 表示指定浮点值的实例。

ValueOf(String)

返回一个 Half 表示指定字符串值的实例。

Wait()

导致当前线程等待,直到它被唤醒,通常是通过 通知 或 中断。

(继承自 Object)
Wait(Int64, Int32)

使当前线程等待直到唤醒,通常是通过 通知 或 中断,或直到经过一定数量的实时。

(继承自 Object)
Wait(Int64)

使当前线程等待直到唤醒,通常是通过 通知 或 中断,或直到经过一定数量的实时。

(继承自 Object)

显式接口实现

名称 说明
IComparable.CompareTo(Object)

将此对象与指定的顺序对象进行比较。

IJavaPeerable.Disposed()

将此对等方标记为已释放,并将disposing调用Dispose设置为 true.

(继承自 JavaObject)
IJavaPeerable.Finalized()

将此对等方标记为已释放,并将disposing调用Dispose设置为 false.

(继承自 JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock

获取此对等方使用的本机控制块指针。

(继承自 JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)

存储运行时提供的标识哈希代码。

(继承自 JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)

替换存储的托管对等状态标志。

(继承自 JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)

更新对等引用,并在引用无效时释放已释放的对等方控制块。

(继承自 JavaObject)
IJavaPeerable.UnregisterFromRuntime()

从运行时的Java对象查找中删除此实例。

扩展方法

名称 说明
GetJniTypeName(IJavaPeerable)

获取实例 self类型的 JNI 名称。

JavaAs<TResult>(IJavaPeerable)

尝试强制self键入TResult,检查强制是否在Java端有效。

JavaCast<TResult>(IJavaObject)

执行 Android 运行时检查的类型转换。

JavaCast<TResult>(IJavaObject)

重复使用兼容的托管对等,或获取请求类型的包装器。

TryJavaCast<TResult>(IJavaPeerable, TResult)

尝试强制self键入TResult,检查强制是否在Java端有效。

适用于