simbot-api/love.forte.simbot/UIntID

UIntID

@SerialName(value = "ID.UInt")

@Serializable(with = UIntID.Serializer::class)

data class UIntID(val number: UInt) : ID, NumberSimilarly(source)

使用 UInt 字面值的 ID 实现。

UInt 不是 Number 的实现，因此 UIntID 并非 NumericalID 类型。但是 UInt 会提供类似于 NumericalID 的一些数值转化类型，并且允许与 NumericalID 进行数值比较。

UIntID 与 IntID 是不同的，不要使用值可能为负的 IntID 来代替 UIntID。 UIntID 在进行 equals 和 compareTo 的时候，如果目标为数值类型且值为负，则会直接将其判定为不相等或小数值。

举个明显的例子：

val ui = UInt.MAX_VALUE
val i = UInt.MAX_VALUE.toInt()

println(ui.toInt() == i)            // true
println(ui == i.toUInt())           // true
println(ui.toInt() compareTo i)     // 0
println(ui compareTo i.toUInt())    // 0

val uiID: ID = ui.ID
val iID: ID = i.ID

println(uiID == iID)                // false
println(uiID compareTo iID)         // 1

在JVM中，当仅作为数值而互相转化、比较时，ui 和 i 的实际数值是一样的，而当它们各自作为 UIntID 和 IntID 时，不论是 equals 还是 compareTo 的结果都表明它们是不同的。