函数
func CJ_CORE_AddAtexitCallback(() -> Unit)
public func CJ_CORE_AddAtexitCallback(callback: () -> Unit): Unit
功能:注册退出函数,当前进程退出时执行该函数。
说明:
此处建议使用 os 库内 Process.atexit 函数,除非有制作进程管理框架的需要,否则不建议使用。
参数:
- callback: () ->Unit - 注册的退出函数。
func CJ_CORE_ExecAtexitCallbacks()
public func CJ_CORE_ExecAtexitCallbacks(): Unit
功能:执行注册的退出函数,执行到此函数直接结束当前进程。
说明:
此处建议使用 os 库内 Process.exit 函数,除非有制作进程管理框架的需要,否则不建议使用。
func acquireArrayRawData<T>(Array<T>) where T <: CType
public unsafe func acquireArrayRawData<T>(arr: Array<T>): CPointerHandle<T> where T <: CType
功能:获取 Array<T> 中数据的原始指针实例,T 需要满足 CType 约束。
注意:
指针使用完后需要及时用 releaseArrayRawData 函数释放该指针。 指针的获取和释放之间仅可包含简单的 foreign C 函数调用等逻辑,不构造例如 CString 等的仓颉对象,否则可能造成不可预期现象。
参数:
- arr: Array<T> - 待获取原始指针的数组。
返回值:
- CPointerHandle<T> - 数组的原始指针实例。
func alignOf<T>() where T <: CType
public func alignOf<T>(): UIntNative where T <: CType
功能:获取类型 T 的内存对齐值。
返回值:
- UIntNative - 对类型 T 做内存对齐的字节数。
func eprint(String, Bool)
public func eprint(str: String, flush!: Bool = true): Unit
功能:用于打印错误消息。
如抛出异常时,消息将打印到标准错误文本流(stderr),而不是标准输出(stdout)。
参数:
func eprintln(String)
public func eprintln(str: String): Unit
功能:用于打印错误消息,末尾添加换行。
如抛出异常时,消息将打印到标准错误文本流(stderr),而不是标准输出(stdout)。
参数:
- str: String - 待输出的字符串。
func ifNone<T>(Option<T>, () -> Unit)
public func ifNone<T>(o: Option<T>, action: () -> Unit): Unit
功能:如果输入是 Option.None 类型数据,则执行 action 函数。
参数:
func ifSome<T>(Option<T>, (T) -> Unit)
public func ifSome<T>(o: Option<T>, action: (T) -> Unit): Unit
功能:如果输入是 Option.Some 类型数据,则执行 action 函数。
参数:
- o: Option<T> - 待判断是否为 Option.Some 的 Option<T> 类型实例,同时其封装的
T
类型实例将作为 action 函数的输入。 - action: (T) ->Unit - 待执行函数。
func print(Bool, Bool)
public func print(b: Bool, flush!: Bool = false): Unit
功能:向控制台输出 Bool 类型数据的字符串表达。
注意:
下列 print、 println、 eprint、 eprintln 函数默认为 UTF-8 编码。 windows 环境需手动执行命令 chcp 65001(将 cmd 更改为 UTF-8 编码)。
参数:
func print(Float16, Bool)
public func print(f: Float16, flush!: Bool = false): Unit
功能:向控制台输出 Float16 类型数据的字符串表达。
参数:
func print(Float32, Bool)
public func print(f: Float32, flush!: Bool = false): Unit
功能:向控制台输出 Float32 类型数据的字符串表达。
参数:
func print(Float64, Bool)
public func print(f: Float64, flush!: Bool = false): Unit
功能:向控制台输出 Float64 类型数据的字符串表达。
参数:
func print(Int16, Bool)
public func print(i: Int16, flush!: Bool = false): Unit
功能:向控制台输出 Int16 类型数据的字符串表达。
参数:
func print(Int32, Bool)
public func print(i: Int32, flush!: Bool = false): Unit
功能:向控制台输出 Int32 类型数据的字符串表达。
参数:
func print(Int64, Bool)
public func print(i: Int64, flush!: Bool = false): Unit
功能:向控制台输出 Int64 类型数据的字符串表达。
参数:
func print(Int8, Bool)
public func print(i: Int8, flush!: Bool = false): Unit
功能:向控制台输出 Int8 类型数据的字符串表达。
参数:
func print(Rune, Bool)
public func print(c: Rune, flush!: Bool = false): Unit
功能:向控制台输出 Rune 类型数据的字符串表达。
参数:
func print(String, Bool)
public func print(str: String, flush!: Bool = false): Unit
功能:向控制台输出指定字符串。
参数:
func print(UInt16, Bool)
public func print(i: UInt16, flush!: Bool = false): Unit
功能:向控制台输出 UInt16 类型数据的字符串表达。
参数:
func print(UInt32, Bool)
public func print(i: UInt32, flush!: Bool = false): Unit
功能:向控制台输出 UInt32 类型数据的字符串表达。
参数:
func print(UInt64, Bool)
public func print(i: UInt64, flush!: Bool = false): Unit
功能:向控制台输出 UInt64 类型数据的字符串表达。
参数:
func print(UInt8, Bool)
public func print(i: UInt8, flush!: Bool = false): Unit
功能:向控制台输出 UInt8 类型数据的字符串表达。
参数:
func print<T>(T, Bool) where T <: ToString
public func print<T>(arg: T, flush!: Bool = false): Unit where T <: ToString
功能:向控制台输出 T
类型实例的字符串表示。
参数:
func println()
public func println(): Unit
功能:向标准输出(stdout)输出换行符。
func println(Bool)
public func println(b: Bool): Unit
功能:向控制台输出 Bool 类型数据的字符串表达,末尾添加换行。
参数:
func println(Float16)
public func println(f: Float16): Unit
功能:向控制台输出 Float16 类型数据的字符串表达,末尾添加换行。
参数:
func println(Float32)
public func println(f: Float32): Unit
功能:向控制台输出 Float32 类型数据的字符串表达,末尾添加换行。
参数:
func println(Float64)
public func println(f: Float64): Unit
功能:向控制台输出 Float64 类型数据的字符串表达,末尾添加换行。
参数:
func println(Int16)
public func println(i: Int16): Unit
功能:向控制台输出 Int16 类型数据的字符串表达,末尾添加换行。
参数:
func println(Int32)
public func println(i: Int32): Unit
功能:向控制台输出 Int32 类型数据的字符串表达,末尾添加换行。
参数:
func println(Int64)
public func println(i: Int64): Unit
功能:向控制台输出 Int64 类型数据的字符串表达,末尾添加换行。
参数:
func println(Int8)
public func println(i: Int8): Unit
功能:向控制台输出 Int8 类型数据的字符串表达,末尾添加换行。
参数:
func println(Rune)
public func println(c: Rune): Unit
功能:向控制台输出 Rune 类型数据的字符串表达,末尾添加换行。
参数:
func println(String)
public func println(str: String): Unit
功能:向控制台输出指定字符串,末尾添加换行。
参数:
- str: String - 待输出的字符串。
func println(UInt16)
public func println(i: UInt16): Unit
功能:向控制台输出 UInt16 类型数据的字符串表达,末尾添加换行。
参数:
func println(UInt32)
public func println(i: UInt32): Unit
功能:向控制台输出 UInt32 类型数据的字符串表达,末尾添加换行。
参数:
func println(UInt64)
public func println(i: UInt64): Unit
功能:向控制台输出 UInt64 类型数据的字符串表达,末尾添加换行。
参数:
func println(UInt8)
public func println(i: UInt8): Unit
功能:向控制台输出 UInt8 类型数据的字符串表达,末尾添加换行。
参数:
func println<T>(T) where T <: ToString
public func println<T>(arg: T): Unit where T <: ToString
功能:向控制台输出 T
类型实例的字符串表示,末尾添加换行。
参数:
- arg: T - 待输出的数据,支持实现了 ToString 接口的类型。
func refEq(Object, Object)
public func refEq(a: Object, b: Object): Bool
功能:判断两个 Object 实例的内存地址是否相同。
参数:
返回值:
func releaseArrayRawData<T>(CPointerHandle<T>) where T <: CType
public unsafe func releaseArrayRawData<T>(handle: CPointerHandle<T>): Unit where T <: CType
功能:释放原始指针实例,该实例通过 acquireArrayRawData 获取。
参数:
- handle: CPointerHandle<T> - 待释放的指针实例。
func sizeOf<T>() where T <: CType
public func sizeOf<T>(): UIntNative where T <: CType
功能:获取类型 T 所占用的内存空间大小。
返回值:
- UIntNative - 类型 T 所占用内存空间的字节数。
func zeroValue<T>()
public unsafe func zeroValue<T>(): T
功能:获取一个已全零初始化的 T 类型实例。
注意:
这个实例一定要赋值为正常初始化的值再使用,否则将引发程序崩溃。
返回值:
- T - 一个已全零初始化的 T 类型实例。