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

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

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

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

• UShortArray: массив беззнаковых short

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

• ULongArray: массив беззнаковых long

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

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

Диапазоны и прогрессии для целых чисел без знака поддерживаются классами 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 явно помечают литерал как беззнаковый long:

  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 позволяет представлять нативные объявления, содержащие беззнаковые типы в сигнатуре. Преобразование не заменит беззнаковые целые числа знаковыми, сохраняя семантику неизменной.