Spec-Zone.ru › Kotlin 1.6

Worker

kotlin-stdlib / kotlin.native.concurrent / Worker
Требования к платформе и версии: Native (1.3)
inline class Worker

Класс, представляющий работника.

Свойства

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

id

val id: Int
Требования к платформе и версии: Native (1.3)

name

Имя работника, указанное в Worker.start или по умолчанию "worker $id",

val name: String

Функции

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

asCPointer

Преобразовать работника в значение COpaquePointer, которое можно передать через указатель native void*. Может использоваться в качестве аргумента Worker.fromCPointer.

fun asCPointer(): COpaquePointer?
Требования к платформе и версии: Native (1.3)

execute

Планирует задачу для дальнейшего выполнения в работнике. Execute — это операция в две фазы:

fun <T1, T2> execute(
    mode: TransferMode, 
    producer: () -> T1, 
    job: (T1) -> T2
): Future<T2>
Требования к платформе и версии: Native (1.3)

executeAfter

Планирует задачу для дальнейшего выполнения в работнике. Параметр operation должен быть либо замороженным, либо выполнение должно быть запланировано на текущего работника. В противном случае будет выброшено исключение IllegalStateException. При использовании -Xworker-exception-handling=use-hook, если работник был создан с errorReporting значением true, любые исключения, выходящие из operation, будут обработаны с помощью processUnhandledException.

fun executeAfter(
    afterMicroseconds: Long = 0, 
    operation: () -> Unit)
Требования к платформе и версии: Native (1.3)

park

Останавливает выполнение текущего работника до тех пор, пока не прибудет новый запрос или не истечет время ожидания, указанное в timeoutMicroseconds. Если process равно true, элементы очереди ожиданий обрабатываются, включая отложенные запросы. Обратите внимание, что таким образом может быть обработано несколько запросов.

fun park(
    timeoutMicroseconds: Long, 
    process: Boolean = false
): Boolean
Требования к платформе и версии: Native (1.3)

processQueue

Обработать ожидающую(ие) задачу(и) в очереди этого работника. Обратите внимание, что задачи, запланированные с помощью executeAfter с ненулевым временем ожидания, не обрабатываются таким образом. Если запрос на завершение поступает во время обработки очереди через этот API, работник помечается как завершенный и выйдет из системы, как только текущий запрос будет завершен.

fun processQueue(): Boolean
Требования к платформе и версии: Native (1.3)

requestTermination

Запрашивает завершение работы работника.

fun requestTermination(
    processScheduledJobs: Boolean = true
): Future<Unit>
Требования к платформе и версии: Native (1.3)

toString

Строковое представление работника.

fun toString(): String

Свойства компаньон-объекта

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

current

Возвращает текущего работника. Контекст работника доступен в любом допустимом контексте Kotlin, но только фактический активный работник, созданный с помощью Worker.start, автоматически обрабатывает запросы на выполнение. В других ситуациях processQueue должен вызываться явно для обработки очереди запросов.

val current: Worker

Функции компаньон-объекта

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

fromCPointer

Создает объект работника из указателя C.

fun fromCPointer(pointer: COpaquePointer?): Worker
Требования к платформе и версии: Native (1.3)

start

Запускает новую планирующую примитив, например, поток, для приема новых задач через интерфейс execute. Обычно новый работник может потребоваться для передачи вычислений на другой ядро, для ввода-вывода может быть лучше использовать асинхронный ввод-вывод в сочетании с более легкими сопрограммами.

fun start(
    errorReporting: Boolean = true, 
    name: String? = null
): Worker

© 2010–2022 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.native.concurrent/-worker/index.html

Spec-Zone.ru

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