Spec-Zone.ru › Kotlin 1.6

Классы перечислений

Наиболее простое применение классов перечислений — реализация безопасных по типу перечислений:

enum class Direction {
    NORTH, SOUTH, WEST, EAST
}

Каждая константа перечисления — это объект. Константы перечисления разделяются запятыми.

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

enum class Color(val rgb: Int) {
    RED(0xFF0000),
    GREEN(0x00FF00),
    BLUE(0x0000FF)
}

Анонимные классы

Константы перечисления могут объявлять собственные анонимные классы со своими методами, а также с переопределением базовых методов.

enum class ProtocolState {
    WAITING {
        override fun signal() = TALKING
    },

    TALKING {
        override fun signal() = WAITING
    };

    abstract fun signal(): ProtocolState
}

Если класс перечисления определяет какие-либо члены, отделяйте определения констант от определений членов точкой с запятой.

Реализация интерфейсов в классах перечислений

Класс перечисления может реализовывать интерфейс (но не может наследоваться от класса), обеспечивая либо общее выполнение членов интерфейса для всех элементов, либо отдельные реализации для каждого элемента в его анонимном классе. Это делается путем добавления интерфейсов, которые необходимо реализовать, в объявление класса перечисления следующим образом:

import java.util.function.BinaryOperator
import java.util.function.IntBinaryOperator

//sampleStart
enum class IntArithmetics : BinaryOperator<Int>, IntBinaryOperator {
    PLUS {
        override fun apply(t: Int, u: Int): Int = t + u
    },
    TIMES {
        override fun apply(t: Int, u: Int): Int = t * u
    };
    
    override fun applyAsInt(t: Int, u: Int) = apply(t, u)
}
//sampleEnd

fun main() {
    val a = 13
    val b = 31
    for (f in IntArithmetics.values()) {
        println("$f($a, $b) = ${f.apply(a, b)}")
    }
}

Работа с константами перечисления

Классы перечислений в Kotlin имеют синтетические методы для перечисления определенных констант перечисления и получения константы перечисления по её имени. Подписи этих методов следующие (предполагается, что имя класса перечисления — EnumClass):

EnumClass.valueOf(value: String): EnumClass
EnumClass.values(): Array<EnumClass>

Метод valueOf() выбрасывает исключение IllegalArgumentException, если указанное имя не соответствует ни одной из констант перечисления, определённых в классе.

Вы можете получить доступ к константам в классе перечисления обобщённым образом, используя функции enumValues<T>() и enumValueOf<T>():

enum class RGB { RED, GREEN, BLUE }

inline fun <reified T : Enum<T>> printAllValues() {
    print(enumValues<T>().joinToString { it.name })
}

printAllValues<RGB>() // prints RED, GREEN, BLUE

Каждая константа перечисления имеет свойства для получения её имени и позиции в объявлении класса перечисления:

val name: String
val ordinal: Int

Константы перечисления также реализуют интерфейс Comparable, при этом естественный порядок — это порядок, в котором они определены в классе перечисления.

Последнее изменение: 07 апреля 2022
Вложенные и внутренние классы Встроенные классы

© 2010–2022 JetBrains s.r.o. and Kotlin Programming Language contributors
Licensed under the Apache License, Version 2.0.
https://kotlinlang.org/docs/enum-classes.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API