kotlin-stdlib/kotlin.native/ForceNativeThreadState

ForceNativeThreadState

@Target(allowedTargets = [AnnotationTarget.FUNCTION])
annotation class ForceNativeThreadState(source)

Forces a thread state switch from Runnable to Native around a direct call to the annotated @SymbolName external fun.

It also alters the exception handling: if a foreign exception is thrown from the annotated function, it terminates the program (unless overridden by kotlin.native.internal.FilterExceptions).

Intended for blocking native functions called via @SymbolName where leaving the thread in the Runnable state would block GC progress.

This is a dangerous internal annotation. Please avoid using it. It may be replaced with something else in the future.

If you absolutely need to use the annotation, please comment at KT-46649.

Since Kotlin

2.4