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] )
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
.