getUuid

Начиная с Kotlin: 2.4

fun ByteBuffer.getUuid(): Uuid

Читает значение Uuid в текущей позиции этого буфера.

Эта функция считывает следующие 16 байтов, начиная с текущей позиции буфера, и собирает из них UUID. В результате позиция буфера увеличивается на 16.

Обратите внимание, что эта функция игнорирует порядок байтов буфера. 16 байтов считываются последовательно: каждый байт представляет следующие 8 бит UUID, начиная с первого байта, представляющего 8 наиболее значимых бит, и заканчивая последним байтом, представляющим 8 наименее значимых бит.

Возвращаемый UUID эквивалентен:

val bytes = ByteArray(16)
byteBuffer.get(bytes)
return Uuid.fromByteArray(bytes)

Возвращаемое значение

Значение UUID, считанное в текущей позиции этого буфера.

См. также

Uuid.toByteArray

Исключения

BufferUnderflowException

Если в буфере осталось менее 16 байтов.

Примеры

import kotlin.test.*
import kotlin.time.Instant
import kotlin.uuid.*

fun main() { 
   //sampleStart 
   val uuidBytes = byteArrayOf(
    0x55, 0x0e, 0x84.toByte(), 0x00, 0xe2.toByte(), 0x9b.toByte(), 0x41, 0xd4.toByte(),
    0xa7.toByte(), 0x16, 0x44, 0x66, 0x55, 0x44, 0x00, 0x00
)
val buffer = java.nio.ByteBuffer.wrap(uuidBytes)
val uuid = buffer.getUuid()

// The uuid has exactly the same 16 bytes
println(uuid.toByteArray().contentEquals(uuidBytes)) // true
println(uuid) // 550e8400-e29b-41d4-a716-446655440000 
   //sampleEnd
}

fun ByteBuffer.getUuid(index: Int): Uuid

Читает значение Uuid по указанному индексу.

Эта функция считывает следующие 16 байтов из этого буфера, начиная с указанного индекса, и собирает из них UUID. Однако позиция буфера не изменяется.

Возвращаемый UUID эквивалентен:

val bytes = ByteArray(16) { i ->
    byteBuffer.get(index + i)
}
return Uuid.fromByteArray(bytes)

за исключением того, что эта функция сначала проверяет, достаточно ли байтов в буфере.

Возвращаемое значение

Значение UUID, считанное по указанному индексу.

Параметры

index

Индекс, по которому нужно считать UUID.

См. также

Uuid.fromByteArray

Исключения

IndexOutOfBoundsException

Если индекс отрицательный или index + 15 не меньше предела этого буфера.

Примеры

import kotlin.test.*
import kotlin.time.Instant
import kotlin.uuid.*

fun main() { 
   //sampleStart 
   val bytes = byteArrayOf(
    0x00, 0x00, 0x55, 0x0e, 0x84.toByte(), 0x00, 0xe2.toByte(), 0x9b.toByte(),
    0x41, 0xd4.toByte(), 0xa7.toByte(), 0x16, 0x44, 0x66, 0x55, 0x44, 0x00, 0x00
)
val buffer = java.nio.ByteBuffer.wrap(bytes)
val uuid = buffer.getUuid(index = 2)

// The uuid has exactly the same 16 bytes
val uuidBytes = bytes.sliceArray(2..<18)
println(uuid.toByteArray().contentEquals(uuidBytes)) // true
println(uuid) // 550e8400-e29b-41d4-a716-446655440000 
   //sampleEnd
}

© 2010–2026 JetBrains s.r.o. and Kotlin Programming Language contributors
Licensed under the Apache License, Version 2.0.
https://kotlinlang.org/api/core/kotlin-stdlib/kotlin.uuid/get-uuid.html