Half 类
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
该 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 的数字会丢失所有小数精度。
本页的某些部分是根据 创建和共享的工作进行的修改,并根据 许可证中所述的条款使用。
构造函数
| 名称 | 说明 |
|---|---|
| Half(Double) |
构造一个新分配 |
| Half(Int16) |
构造表示半精度浮点类型参数的新分配 |
| Half(Single) |
构造一个新分配 |
| Half(String) |
构造表示字符串所表示的半精度浮点值的新分配 |
字段
| 名称 | 说明 |
|---|---|
| Epsilon |
Epsilon 是 1.0 与由半精度浮点表示的下一个值之间的差异。 |
| LowestValue |
半精度浮点数可能具有最小负值。 |
| MaxExponent |
有限半精度浮点数的最大指数可能具有。 |
| MaxValue |
半精度浮点数的最大正有限值可能具有。 |
| MinExponent |
规范化半精度浮点数的最小指数可能具有。 |
| MinNormal |
半精度浮点数可能具有最小正正值。 |
| MinValue |
半精度浮点数可能具有最小正非零值。 |
| NaN |
半精度浮点数的 Not-Number 表示形式。 |
| NegativeInfinity |
类型半精度浮点数的负无穷大。 |
| NegativeZero |
类型半精度浮点数的负 0。 |
| PositiveInfinity |
类型半精度浮点的正无穷大。 |
| PositiveZero |
类型半精度浮点数的正 0。 |
| Size |
用于表示半精度浮点值的位数。 |
属性
| 名称 | 说明 |
|---|---|
| Class |
返回此 |
| Handle |
基础 Android 实例的句柄。 (继承自 Object) |
| IsNaN |
如果此值 |
| 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() |
返回指定数字的值作为一个 |
| 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() |
以加宽基元转换后的形式 |
| Equals(Int16, Int16) |
如果两个半精度浮点值相等,则返回 true。 |
| Equals(Object) |
测试另一个托管对等方是否引用同一Java对象。 (继承自 JavaObject) |
| Equals(Object) |
指示其他对象是否“等于”此对象。 (继承自 Object) |
| FloatValue() |
以加宽基元转换后的形式 |
| Floor(Int16) |
返回小于或等于指定半精度浮点值的最大半精度浮点值,以小于或等于正无穷大。 |
| GetExponent(Int16) |
返回指定半精度浮点值的表示形式中使用的无偏差指数。 |
| GetHashCode() |
返回对象的哈希代码值。 (继承自 Object) |
| GetSign(Int16) |
返回指定半精度浮点数的符号。 |
| GetSignificand(Int16) |
返回指定半精度浮点值的表示形式中使用的符号或 mantissa。 |
| Greater(Int16, Int16) |
如果上半精度浮点值大于后半精度浮点值(向正无穷大),则返回 true。 |
| GreaterEquals(Int16, Int16) |
如果上半精度浮点值大于或等于下半精度浮点值,则返回 true。 |
| HalfToIntBits(Int16) |
根据上述 |
| HalfToRawIntBits(Int16) |
根据上述 |
| HalfToShortBits(Int16) |
根据上述 |
| HalfValue() |
返回此 |
| HashCode(Int16) |
返回半精度浮点值的哈希代码。 |
| IntBitsToHalf(Int32) |
返回对应于给定位表示形式的半精度浮点值。 |
| IntValue() |
以缩小基元转换后的形式 |
| 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() |
以缩小基元转换后的形式 |
| 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() |
返回指定数字的值作为一个 |
| ToArray<T>() |
从此Java数组包装器创建托管数组。 (继承自 Object) |
| ToFloat(Int16) |
将指定的半精度浮点值转换为单精度浮点值。 |
| ToHalf(Single) |
将指定的单精度浮点值转换为半精度浮点值。 |
| ToHexString(Int16) |
返回指定半精度浮点值的十六进制字符串表示形式。 |
| ToString() |
返回对象的字符串表示形式。 (继承自 Object) |
| ToString(Int16) |
返回指定半精度浮点值的字符串表示形式。 |
| Trunc(Int16) |
返回指定的半精度浮点值的截断的半精度浮点值。 |
| UnregisterFromRuntime() |
从互操作运行时取消注册此Java对等。 (继承自 Object) |
| ValueOf(Int16) |
返回一个 |
| ValueOf(Single) |
返回一个 |
| ValueOf(String) |
返回一个 |
| Wait() |
导致当前线程等待,直到它被唤醒,通常是通过 通知 或 中断。 (继承自 Object) |
| Wait(Int64, Int32) |
使当前线程等待直到唤醒,通常是通过 通知 或 中断,或直到经过一定数量的实时。 (继承自 Object) |
| Wait(Int64) |
使当前线程等待直到唤醒,通常是通过 通知 或 中断,或直到经过一定数量的实时。 (继承自 Object) |
显式接口实现
| 名称 | 说明 |
|---|---|
| IComparable.CompareTo(Object) |
将此对象与指定的顺序对象进行比较。 |
| IJavaPeerable.Disposed() |
将此对等方标记为已释放,并将 |
| IJavaPeerable.Finalized() |
将此对等方标记为已释放,并将 |
| IJavaPeerable.JniObjectReferenceControlBlock |
获取此对等方使用的本机控制块指针。 (继承自 JavaObject) |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
存储运行时提供的标识哈希代码。 (继承自 JavaObject) |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
替换存储的托管对等状态标志。 (继承自 JavaObject) |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
更新对等引用,并在引用无效时释放已释放的对等方控制块。 (继承自 JavaObject) |
| IJavaPeerable.UnregisterFromRuntime() |
从运行时的Java对象查找中删除此实例。 |
扩展方法
| 名称 | 说明 |
|---|---|
| GetJniTypeName(IJavaPeerable) |
获取实例 |
| JavaAs<TResult>(IJavaPeerable) |
尝试强制 |
| JavaCast<TResult>(IJavaObject) |
执行 Android 运行时检查的类型转换。 |
| JavaCast<TResult>(IJavaObject) |
重复使用兼容的托管对等,或获取请求类型的包装器。 |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
尝试强制 |