Типы целых беззнаковых чисел

Беззнаковые массивы и диапазоны

Так же, как и для примитивных типов, для каждого беззнакового типа существует соответствующий тип, представляющий массивы этого типа:

• UByteArray: массив беззнаковых байтов

• UShortArray: массив беззнаковых коротких целых чисел

• UIntArray: массив беззнаковых целых чисел

• ULongArray: массив беззнаковых длинных целых чисел

Как и для массивов знакомых целых чисел, они предоставляют аналогичный API к классу Array, без накладных расходов на автоупаковку.

При использовании беззнаковых массивов вы получите предупреждение, указывающее на то, что эта функция еще не стабильна. Чтобы устранить предупреждение, включите аннотацию @ExperimentalUnsignedTypes. Решать вам, должны ли ваши клиенты явно включать использование вашего API, но помните, что беззнаковые массивы — это нестабильная функция, поэтому API, использующий их, может быть нарушен изменениями языка. Узнайте больше о требованиях к включению.

Диапазоны и прогрессии для UInt и ULong поддерживаются классами UIntRange, UIntProgression, ULongRange, и ULongProgression. Вместе с типами беззнаковых целых чисел эти классы являются стабильными.

Литералы беззнаковых целых чисел

Чтобы упростить использование беззнаковых целых чисел, Kotlin предоставляет возможность помечать целочисленный литерал суффиксом, указывающим на конкретный беззнаковый тип (аналогично Float или Long):

• u и U тег предназначен для беззнаковых литералов. Точный тип определяется на основе ожидаемого типа. Если ожидаемый тип не указан, компилятор будет использовать UInt или ULong, в зависимости от размера литерала:

  val b: UByte = 1u  // UByte, expected type provided
  val s: UShort = 1u // UShort, expected type provided
  val l: ULong = 1u  // ULong, expected type provided
  
  val a1 = 42u // UInt: no expected type provided, constant fits in UInt
  val a2 = 0xFFFF_FFFF_FFFFu // ULong: no expected type provided, constant doesn't fit in UInt
  

• uL и UL явно помечают литерал как беззнаковое длинное целое число:

  val a = 1UL // ULong, even though no expected type provided and constant fits into UInt
  

Сценарии использования

Основной сценарий использования беззнаковых чисел — использование всего диапазона битов целого числа для представления положительных значений.
Например, для представления шестнадцатеричных констант, которые не помещаются в знакомые типы, такие как цвет в формате 32-битного AARRGGBB:

data class Color(val representation: UInt)

val yellow = Color(0xFFCC00CCu)

Вы можете использовать беззнаковые числа для инициализации массивов байтов без явных toByte() преобразований литералов:

val byteOrderMarkUtf8 = ubyteArrayOf(0xEFu, 0xBBu, 0xBFu)

Еще один сценарий использования — взаимодействие с нативными API. Kotlin позволяет представлять нативные объявления, содержащие беззнаковые типы в сигнатуре. Преобразование не заменит беззнаковые целые числа знаковыми, сохраняя при этом семантику.