Объявления уровня пакета

kotlin-stdlib/kotlin.native

Предоставляет функции и типы, специфичные для Kotlin/Native, а также средства взаимодействия с базовой платформой и другими языками.

Типы

BitSet

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


@ObsoleteNativeApi
actual class BitSet(size: Int = ELEMENT_SIZE)

Вектор битов, который при необходимости увеличивается и позволяет задавать, сбрасывать и считывать биты по их индексу.

CName

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



@ExperimentalNativeApi


@Target(allowedTargets = [AnnotationTarget.FUNCTION])

expect annotation class CName(val externName: String = "", val shortName: String = "")

Делает функцию верхнего уровня доступной из кода C/C++ под указанным именем.

CpuArchitecture

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


@ExperimentalNativeApi
enum CpuArchitecture : Enum<CpuArchitecture>

Архитектура центрального процессора.

EagerInitialization

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



@Target(allowedTargets = [AnnotationTarget.PROPERTY])


@ExperimentalStdlibApi

annotation class EagerInitialization

Принудительно задаёт жадную инициализацию свойства верхнего уровня, а не отложенную инициализацию при первом обращении к файлу и/или свойству. Эта аннотация может использоваться как временное средство миграции при переходе от предыдущей схемы инициализации Kotlin/Native («жадная по умолчанию») к новой («отложенная по умолчанию»).

ForceNativeThreadState

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


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

Принудительно переключает состояние потока с Runnable на Native при прямом вызове аннотированного @SymbolName external fun.

FreezingIsDeprecated

Требования к платформе и версии: Common (1.7), Native (1.7), Wasm-JS (1.8), Wasm-WASI (1.8)



@RequiresOptIn(message = "Freezing API is deprecated since 1.7.20. See https://kotlinlang.org/docs/native-migration-guide.html for details", level = RequiresOptIn.Level.WARNING)


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

expect annotation class FreezingIsDeprecated

API заморозки объявлен устаревшим начиная с Kotlin 1.7.20, а поддержка устаревшего менеджера памяти была полностью удалена из компилятора в версии 1.9.20.

HiddenFromObjC

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



@HidesFromObjC


@Target(allowedTargets = [AnnotationTarget.PROPERTY, AnnotationTarget.FUNCTION, AnnotationTarget.CLASS])


@ExperimentalObjCRefinement

expect annotation class HiddenFromObjC

Указывает компилятору Kotlin исключить этот класс, функцию или свойство из публичного API Objective-C.

HidesFromObjC

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



@Target(allowedTargets = [AnnotationTarget.ANNOTATION_CLASS])


@ExperimentalObjCRefinement

expect annotation class HidesFromObjC

Метааннотация, указывающая компилятору Kotlin исключить аннотированный класс, функцию или свойство из публичного API Objective-C.

ImmutableBlob

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

class ImmutableBlob

Неизменяемый массив байтов, создаваемый во время компиляции.

IncorrectDereferenceException

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

class IncorrectDereferenceException : RuntimeException

Исключение, выбрасываемое при обращении к переменной верхнего уровня из недопустимого контекста выполнения.

MemoryModel

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


@ExperimentalNativeApi
enum MemoryModel : Enum<MemoryModel>

Модель памяти.

NoInline

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



@ExperimentalNativeApi


@Target(allowedTargets = [AnnotationTarget.FUNCTION, AnnotationTarget.PROPERTY])

annotation class NoInline

Запрещает встраивание этой функции/свойства специализированным встраивателем K/N. Примечание: это не связано с ключевым словом inline — это отдельный этап встраивания, предназначенный для оптимизации. Однако функция/свойство всё ещё может быть встроено LLVM.

ObjCEnum

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



@Target(allowedTargets = [AnnotationTarget.CLASS])


@ExperimentalObjCEnum

expect annotation class ObjCEnum(val name: String = "", val swiftName: String = "")

Указывает компилятору Kotlin сгенерировать typedef NS_ENUM для аннотированного класса перечисления. Имя сгенерированного типа будет совпадать с именем типа перечисления с добавленным суффиксом «NSEnum». Это имя можно переопределить параметром «name», который воспринимается как точное имя. Кроме того, можно указать отдельное имя для Swift с помощью параметра swiftName. В Objective-C литералы перечисления всегда будут иметь префикс с именем типа, причём первая буква имени элемента всегда будет заглавной, независимо от того, задано ли имя неявно или явно через ObjCName либо EntryName, поскольку они находятся в глобальном пространстве имён. В Swift такие префиксы для устранения неоднозначности добавляться не будут. Значения NSEnum доступны через свойство «nsEnum».

ObjCName

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



@Target(allowedTargets = [AnnotationTarget.CLASS, AnnotationTarget.PROPERTY, AnnotationTarget.VALUE_PARAMETER, AnnotationTarget.FUNCTION])


@ExperimentalObjCName

expect annotation class ObjCName(val name: String = "", val swiftName: String = "", val exact: Boolean = false)

Указывает компилятору Kotlin использовать пользовательское имя Objective-C и/или Swift для этого класса, свойства, параметра или функции.

ObsoleteNativeApi

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



@RequiresOptIn(message = "This API is obsolete and subject to removal in a future release.", level = RequiresOptIn.Level.ERROR)


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

actual annotation class ObsoleteNativeApi

Эта аннотация помечает API стандартной библиотеки Kotlin/Native как устаревший и выводимый из эксплуатации.

OsFamily

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


@ExperimentalNativeApi
enum OsFamily : Enum<OsFamily>

Семейство операционных систем.

Platform

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


@ExperimentalNativeApi
object Platform

Объект, описывающий текущую платформу, на которой выполняется программа.

RefinesInSwift

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



@Target(allowedTargets = [AnnotationTarget.ANNOTATION_CLASS])


@ExperimentalObjCRefinement

expect annotation class RefinesInSwift

Метааннотация, указывающая компилятору Kotlin пометить аннотированную функцию или свойство как swift_private в сгенерированном API Objective-C.

ReportUnhandledExceptionHook

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


@ExperimentalNativeApi
typealias ReportUnhandledExceptionHook = (Throwable) -> Unit

Псевдоним типа, описывающий пользовательский обработчик регистрации исключений.

ShouldRefineInSwift

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



@RefinesInSwift


@Target(allowedTargets = [AnnotationTarget.PROPERTY, AnnotationTarget.FUNCTION])


@ExperimentalObjCRefinement

expect annotation class ShouldRefineInSwift

Указывает компилятору Kotlin пометить эту функцию или свойство как swift_private в сгенерированном API Objective-C.

SymbolName

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


@Target(allowedTargets = [AnnotationTarget.FUNCTION])
annotation class SymbolName(val name: String)

Это опасная устаревшая внутренняя аннотация. Не используйте её.

Vector128

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

typealias Vector128 = kotlinx.cinterop.Vector128

Функции

asCPointer

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

fun ImmutableBlob.asCPointer(offset: Int = 0): CPointer<ByteVar>

Возвращает стабильный указатель C на данные по определённому смещению; это удобно для передачи ресурса в API C.

asUCPointer

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

fun ImmutableBlob.asUCPointer(offset: Int = 0): CPointer<UByteVar>

Возвращает стабильный указатель C на данные по определённому смещению; это удобно для передачи ресурса в API C.

getCharAt

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


@ExperimentalNativeApi
external fun ByteArray.getCharAt(index: Int): Char

Получает значение Char из байтового буфера ByteArray по указанному индексу

getDoubleAt

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


@ExperimentalNativeApi
external fun ByteArray.getDoubleAt(index: Int): Double

Получает значение Double из байтового буфера ByteArray по указанному индексу

getFloatAt

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


@ExperimentalNativeApi
external fun ByteArray.getFloatAt(index: Int): Float

Получает значение Float из байтового буфера ByteArray по указанному индексу

getIntAt

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


@ExperimentalNativeApi
external fun ByteArray.getIntAt(index: Int): Int

Получает значение Int из байтового буфера ByteArray по указанному индексу

getLongAt

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


@ExperimentalNativeApi
external fun ByteArray.getLongAt(index: Int): Long

Получает значение Long из байтового буфера ByteArray по указанному индексу

getShortAt

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


@ExperimentalNativeApi
external fun ByteArray.getShortAt(index: Int): Short

Получает значение Short из байтового буфера ByteArray по указанному индексу

getStackTraceAddresses

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


@ExperimentalNativeApi
fun Throwable.getStackTraceAddresses(): List<Long>

Возвращает список адресов трассировки стека, представляющих трассировку стека, относящуюся к этому исключению.

getUByteAt

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


@ExperimentalNativeApi
fun ByteArray.getUByteAt(index: Int): UByte

Получает значение UByte из байтового буфера ByteArray по указанному индексу

getUIntAt

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



@ExperimentalNativeApi


@ExperimentalUnsignedTypes

external fun ByteArray.getUIntAt(index: Int): UInt

Получает значение UInt из байтового буфера ByteArray по указанному индексу

getULongAt

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



@ExperimentalNativeApi


@ExperimentalUnsignedTypes

external fun ByteArray.getULongAt(index: Int): ULong

Получает значение ULong из байтового буфера ByteArray по указанному индексу

getUnhandledExceptionHook

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


@ExperimentalNativeApi
fun getUnhandledExceptionHook(): ReportUnhandledExceptionHook?

Возвращает пользовательский обработчик необработанных исключений, заданный с помощью setUnhandledExceptionHook, или null, если пользовательские обработчики не были заданы.

getUShortAt

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



@ExperimentalNativeApi


@ExperimentalUnsignedTypes

external fun ByteArray.getUShortAt(index: Int): UShort

Получает значение UShort из байтового буфера ByteArray по указанному индексу

identityHashCode

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


@ExperimentalNativeApi
external fun Any?.identityHashCode(): Int

Вычисляет хеш-код идентичности, остающийся стабильным при возможном перемещении объекта диспетчером памяти.

immutableBlobOf

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

external fun immutableBlobOf(vararg elements: Short): ImmutableBlob

Создаёт ImmutableBlob из константных данных времени компиляции.

initRuntimeIfNeeded

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

fun initRuntimeIfNeeded()

Инициализирует среду выполнения Kotlin для текущего потока, если она ещё не была инициализирована.

isExperimentalMM

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


@ExperimentalStdlibApi
fun isExperimentalMM(): Boolean

processUnhandledException

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


@ExperimentalNativeApi
external fun processUnhandledException(throwable: Throwable)

Выполняет обработку необработанного исключения по умолчанию.

setCharAt

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


@ExperimentalNativeApi
external fun ByteArray.setCharAt(index: Int, value: Char)

Записывает значение Char в байтовый буфер ByteArray по указанному индексу

setDoubleAt

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


@ExperimentalNativeApi
external fun ByteArray.setDoubleAt(index: Int, value: Double)

Записывает значение Double в байтовый буфер ByteArray по указанному индексу

setFloatAt

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


@ExperimentalNativeApi
external fun ByteArray.setFloatAt(index: Int, value: Float)

Записывает значение Float в байтовый буфер ByteArray по указанному индексу

setIntAt

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


@ExperimentalNativeApi
external fun ByteArray.setIntAt(index: Int, value: Int)

Записывает значение Int в байтовый буфер ByteArray по указанному индексу

setLongAt

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


@ExperimentalNativeApi
external fun ByteArray.setLongAt(index: Int, value: Long)

Записывает значение Long в байтовый буфер ByteArray по указанному индексу

setShortAt

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


@ExperimentalNativeApi
external fun ByteArray.setShortAt(index: Int, value: Short)

Записывает значение Short в байтовый буфер ByteArray по указанному индексу

setUByteAt

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


@ExperimentalNativeApi
external fun ByteArray.setUByteAt(index: Int, value: UByte)

Записывает значение UByte в байтовый буфер ByteArray по указанному индексу

setUIntAt

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


@ExperimentalNativeApi
external fun ByteArray.setUIntAt(index: Int, value: UInt)

Записывает значение UInt в байтовый буфер ByteArray по указанному индексу

setULongAt

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



@ExperimentalNativeApi


@ExperimentalUnsignedTypes

external fun ByteArray.setULongAt(index: Int, value: ULong)

Записывает значение ULong в байтовый буфер ByteArray по указанному индексу

setUnhandledExceptionHook

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



@ExperimentalNativeApi


@IgnorableReturnValue

fun setUnhandledExceptionHook(hook: ReportUnhandledExceptionHook?): ReportUnhandledExceptionHook?

Устанавливает обработчик необработанных исключений и возвращает предыдущий обработчик или null, если пользовательские обработчики ранее не задавались.

setUShortAt

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



@ExperimentalNativeApi


@ExperimentalUnsignedTypes

external fun ByteArray.setUShortAt(index: Int, value: UShort)

Записывает значение UShort в байтовый буфер ByteArray по указанному индексу

terminateWithUnhandledException

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


@ExperimentalNativeApi
external fun terminateWithUnhandledException(throwable: Throwable): Nothing

toByteArray

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

external fun ImmutableBlob.toByteArray(startIndex: Int = 0, endIndex: Int = size): ByteArray

Копирует данные из этого blob в новый объект ByteArray.

toUByteArray

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


@ExperimentalUnsignedTypes
external fun ImmutableBlob.toUByteArray(startIndex: Int = 0, endIndex: Int = size): UByteArray

Копирует данные из этого blob в новый объект UByteArray.

vectorOf

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

external fun vectorOf(f0: Float, f1: Float, f2: Float, f3: Float): Vector128

external fun vectorOf(f0: Int, f1: Int, f2: Int, f3: Int): Vector128

© 2010–2026 JetBrains s.r.o. and Kotlin Programming Language contributors
Licensed under the Apache License, Version 2.0.
https://kotlinlang.org/api/core/kotlin-stdlib/kotlin.native/index.html