putUInt16Le

fun ByteArray.putUInt16Le(offset: Int, value: UInt, validRange: UIntRange = UShort.MIN_VALUE.toUInt()..UShort.MAX_VALUE.toUInt())

Writes a UInt16 value to the byte array at the specified offset in little-endian order.

This function takes an unsigned integer value and writes it as two bytes (UInt16) into the byte array at the specified offset using little-endian byte order. It also validates that the value falls within a specified range, ensuring it can be represented as an unsigned two-byte integer.

Parameters

offset

The offset (index) in the byte array where the UInt16 value should be written. Must be within the valid range of the array's indices.

value

The UInt16 value to be written.

validRange

The valid range for the value. Defaults to UShort.MIN_VALUE to UShort.MAX_VALUE (i.e., 0 to 65535). Any value outside this range will cause an exception to be thrown.

Throws

If the value is outside the specified validRange.

If the offset or offset + 1 is negative or greater than or equal to the array's size.