부호 없는 정수 타입

정수 타입 외에도 Kotlin은 부호 없는 정수를 위해 다음 타입을 제공합니다.

타입	크기 (비트)	최솟값	최댓값
UByte	8	0	255
UShort	16	0	65,535
UInt	32	0	4,294,967,295 (232 - 1)
ULong	64	0	18,446,744,073,709,551,615 (264 - 1)

부호 없는 타입은 부호 있는 타입의 대부분의 연산을 지원합니다.

부호 없는 숫자는 동일한 너비의 해당 부호 있는 타입을 포함하는 단일 저장 프로퍼티를 가진 인라인 클래스로 구현됩니다. 부호 없는 정수 타입과 부호 있는 정수 타입 간에 변환하려는 경우, 모든 함수 호출과 연산이 새로운 타입을 지원하도록 코드를 업데이트해야 합니다.

부호 없는 배열과 범위

부호 없는 배열과 그에 대한 연산은 베타 상태입니다. 언제든지 호환되지 않게 변경될 수 있습니다. 옵트인(Opt-in)이 필요합니다(자세한 내용은 아래 참조).

기본 타입과 마찬가지로 각 부호 없는 타입은 해당 타입의 배열을 나타내는 대응하는 타입을 가집니다.

• UByteArray: 부호 없는 바이트 배열.
• UShortArray: 부호 없는 쇼트 배열.
• UIntArray: 부호 없는 인트 배열.
• ULongArray: 부호 없는 롱 배열.

부호 있는 정수 배열과 마찬가지로, 이들은 박싱 오버헤드 없이 Array 클래스와 유사한 API를 제공합니다.

부호 없는 배열을 사용하면 이 기능이 아직 안정적이지 않다는 경고를 받게 됩니다. 경고를 제거하려면 @ExperimentalUnsignedTypes 어노테이션으로 옵트인해야 합니다. 클라이언트가 API 사용에 명시적으로 옵트인해야 하는지 여부는 여러분이 결정할 일이지만, 부호 없는 배열은 안정적인 기능이 아니라는 점을 명심하십시오. 따라서 이를 사용하는 API는 언어 변경으로 인해 손상될 수 있습니다. 옵트인 요구 사항에 대해 자세히 알아보기.

범위와 진행은 UIntRange, UIntProgression, ULongRange, ULongProgression 클래스에 의해 UInt 및 ULong에 대해 지원됩니다. 부호 없는 정수 타입과 함께 이 클래스들은 안정적입니다.

부호 없는 정수 리터럴

부호 없는 정수를 더 쉽게 사용하기 위해 정수 리터럴에 특정 부호 없는 타입을 나타내는 접미사를 추가할 수 있습니다(Float의 F 또는 Long의 L과 유사하게).

• 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은 리터럴이 부호 없는 롱(unsigned long)이어야 함을 명시적으로 지정합니다.

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

사용 사례

부호 없는 숫자의 주요 사용 사례는 정수의 전체 비트 범위를 활용하여 양수 값을 나타내는 것입니다. 예를 들어, 32비트 AARRGGBB 형식의 색상과 같이 부호 있는 타입에 맞지 않는 16진수 상수를 나타내는 것입니다.

data class Color(val representation: UInt)

val yellow = Color(0xFFCC00CCu)

명시적인 toByte() 리터럴 캐스트 없이 부호 없는 숫자를 사용하여 바이트 배열을 초기화할 수 있습니다.

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

또 다른 사용 사례는 네이티브 API와의 상호 운용성입니다. Kotlin은 서명에 부호 없는 타입을 포함하는 네이티브 선언을 표현할 수 있습니다. 매핑은 부호 없는 정수를 부호 있는 정수로 대체하지 않으며 의미를 변경하지 않고 유지합니다.

비목표

부호 없는 정수는 양수와 0만 나타낼 수 있지만, 애플리케이션 도메인에서 음수가 아닌 정수를 요구하는 곳에 이를 사용하는 것은 목표가 아닙니다. 예를 들어, 컬렉션 크기 또는 컬렉션 인덱스 값의 타입으로.

몇 가지 이유가 있습니다.

• 부호 있는 정수를 사용하면 의도치 않은 오버플로우를 감지하고 오류 조건을 알리는 데 도움이 될 수 있습니다. 예를 들어, 빈 리스트에 대해 List.lastIndex가 -1인 경우와 같이.
• 부호 없는 정수는 부호 있는 정수의 범위 제한 버전으로 취급될 수 없습니다. 그 이유는 값의 범위가 부호 있는 정수 범위의 부분 집합이 아니기 때문입니다.
• 부호 있는 정수도, 부호 없는 정수도 서로의 하위 타입이 아닙니다.