TestTimeSource

kotlin-stdlib / kotlin.time / TestTimeSource

Требования к платформе и версии: JVM (1.9), JS (1.9), Native (1.9)

class TestTimeSource : AbstractLongTimeSource

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

Текущее значение можно увеличить на указанную длительность с помощью оператора plusAssign:

val timeSource = TestTimeSource()
timeSource += 10.seconds

Отметки времени, возвращаемые этим источником времени, можно сравнивать на разницу с другими отметками времени, полученными из того же источника времени.

Примечание к реализации: текущее значение хранится как Long число наносекунд, поэтому оно способно представить диапазон времени примерно ±292 года. Если значение чтения переполнится в результате операции plusAssign, будет брошено исключение IllegalStateException.

Конструкторы

Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

<init>

TestTimeSource()

Функции

Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

plusAssign

Увеличивает текущее значение чтения этого источника времени на указанную duration.

operator fun plusAssign(duration: Duration)

Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

read

Этот защищённый метод должен быть переопределён для возвращения текущего значения чтения источника времени, выраженного как Long число в единицах, указанных свойством unit.

fun read(): Long

Расширяющие функции

Требования к платформе и версии: JVM (1.9), JS (1.9), Native (1.9)

measureTime

Выполняет заданную функцию block и возвращает длительность интервала прошедшего времени.

fun TimeSource.measureTime(block: () -> Unit): Duration

Требования к платформе и версии: JVM (1.9), JS (1.9), Native (1.9)

measureTimedValue

Выполняет заданный block и возвращает экземпляр класса TimedValue, содержащий результат выполнения функции и длительность интервала прошедшего времени.

fun <T> TimeSource.measureTimedValue(
    block: () -> T
): TimedValue<T>

© 2010–2023 JetBrains s.r.o. and Kotlin Programming Language contributors
Licensed under the Apache License, Version 2.0.
https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.time/-test-time-source/index.html