Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.syntblaze.com/llms.txt

Use this file to discover all available pages before exploring further.

UInt is a value class in Kotlin that represents a 32-bit unsigned integer. It provides a numeric type strictly constrained to non-negative values, operating within a range of 0 to 4,294,967,295 (232−12^{32} - 1). At runtime, UInt wraps a standard primitive Int. While it is designed to avoid object allocation overhead where possible, it is subject to boxing depending on how it is used within the type system.

​
Instantiation and Syntax

UInt literals are defined by appending the u or U suffix to an integer literal. The compiler can infer the type automatically, or it can be declared explicitly. 
val inferredUInt = 42u               // Type inferred as UInt
val explicitUInt: UInt = 42U         // Explicit type declaration
val hexUInt = 0xFFFFFFFFu            // Hexadecimal literal
val binUInt = 0b10101010u            // Binary literal

​
Type Conversion

Kotlin enforces strict type safety; implicit conversions between signed Int and unsigned UInt are prohibited. Explicit conversion functions must be invoked. 
val signedInt: Int = 42
val unsignedInt: UInt = signedInt.toUInt()

val stringToUInt: UInt = "4294967295".toUInt()
val backToInt: Int = unsignedInt.toInt()
When converting a negative signed Int to a UInt, the bitwise representation remains identical, resulting in the two’s complement unsigned equivalent. 
val negativeInt: Int = -1
val wrappedUInt: UInt = negativeInt.toUInt() // Evaluates to 4294967295u (UInt.MAX_VALUE)

​
Arithmetic and Overflow Semantics

UInt supports standard arithmetic and bitwise operators. Operations are executed with unsigned semantics, meaning division and modulo operations evaluate differently than their signed counterparts. 
val a = 10u
val b = 3u
val division = a / b       // Evaluates to 3u
val remainder = a % b      // Evaluates to 1u
val bitwiseShift = a shl 2 // Evaluates to 40u
Like signed integers, UInt operations are subject to silent overflow and underflow, wrapping around the 32-bit boundary. 
val max: UInt = UInt.MAX_VALUE
val overflow: UInt = max + 1u // Evaluates to 0u

val min: UInt = UInt.MIN_VALUE
val underflow: UInt = min - 1u // Evaluates to 4294967295u

​
JVM Representation, Boxing, and Unboxing

Because the underlying Java Virtual Machine (JVM) lacks native support for unsigned integer types, Kotlin compiles UInt down to a standard Java primitive int. The Kotlin compiler handles the unsigned arithmetic by substituting the appropriate JVM intrinsics or library functions (e.g., Integer.divideUnsigned). However, because UInt is a value class, it is subject to boxing and unboxing. Boxing occurs when the compiler is forced to instantiate an actual wrapper object on the heap instead of using the underlying primitive int. This introduces memory allocation and performance penalties. UInt is forced to box under the following conditions:
  1. Nullability: When declared as a nullable type (UInt?).
  2. Generics: When used as a generic type argument (e.g., List<UInt>).
  3. Upcasting: When cast to Any or an interface.
val unboxed: UInt = 42u                    // Represented as primitive 'int' on the JVM (no allocation)
val boxedNullable: UInt? = 42u             // Boxed into a wrapper object (heap allocation)
val boxedGeneric: List<UInt> = listOf(42u) // Boxed due to generic type erasure
val boxedAny: Any = 42u                    // Boxed due to upcasting

​
Name Mangling

To prevent signature clashes at the bytecode level—since both unboxed Int and UInt erase to int—the Kotlin compiler applies name mangling to functions accepting unboxed UInt parameters. 
// Kotlin source
fun process(value: UInt) { }

// Decompiled Java bytecode equivalent
public static final void process-WZ4Q5Ns(int value) { }

​
Arrays

To maintain performance and avoid the boxing overhead associated with generic arrays (like Array<UInt>), Kotlin provides UIntArray. This specialized array type is backed directly by a primitive int[] on the JVM but exposes UInt elements to the Kotlin type system, ensuring no wrapper objects are allocated for its elements. 
val unsignedArray = UIntArray(5) { it.toUInt() } // Backed by int[], no boxing overhead
val literalArray = uintArrayOf(1u, 2u, 3u)       // Backed by int[], no boxing overhead

val boxedArray = Array<UInt>(3) { 0u }           // Avoid: incurs heap allocation for every element
Master Kotlin with Deep Grasping Methodology!Learn More