kotlin-stdlib/kotlin/ExperimentalStdlibApi

ExperimentalStdlibApi

@Target(allowedTargets = [AnnotationTarget.CLASS, AnnotationTarget.ANNOTATION_CLASS, AnnotationTarget.PROPERTY, AnnotationTarget.FIELD, AnnotationTarget.LOCAL_VARIABLE, AnnotationTarget.VALUE_PARAMETER, AnnotationTarget.CONSTRUCTOR, AnnotationTarget.FUNCTION, AnnotationTarget.PROPERTY_GETTER, AnnotationTarget.PROPERTY_SETTER, AnnotationTarget.TYPEALIAS])
annotation class ExperimentalStdlibApi(source)

This annotation marks the standard library API that is considered experimental and is not subject to the general compatibility guarantees given for the standard library: the behavior of such API may be changed or the API may be removed completely in any further release.

Beware using the annotated API especially if you're developing a library, since your library might become binary incompatible with the future versions of the standard library.

Any usage of a declaration annotated with @ExperimentalStdlibApi must be accepted either by annotating that usage with the OptIn annotation, e.g. @OptIn(ExperimentalStdlibApi::class), or by using the compiler argument -opt-in=kotlin.ExperimentalStdlibApi.

Since Kotlin

1.3