函数

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 等的仓颉对象,否则可能造成不可预期现象。

返回值:

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)。

参数:

  • str: String - 待输出的字符串。
  • flush!: Bool - 是否清空缓存,true 清空,false 不清空,默认 false。

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 函数。

参数:

  • o: Option<T> - 待判断是否为 Option.None 的 Option<T> 类型实例,同时其封装的 T 类型实例将作为 action 函数的输入。
  • action: () ->Unit - 待执行函数。

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 类型数据的字符串表达。

注意:

下列 printprintlneprinteprintln 函数默认为 UTF-8 编码。 windows 环境需手动执行命令 chcp 65001(将 cmd 更改为 UTF-8 编码)。

参数:

  • b: Bool - 待输出的 Bool 类型数据。
  • flush!: Bool - 是否清空缓存,true 清空,false 不清空,默认 false。

func print(Float16, Bool)

public func print(f: Float16, flush!: Bool = false): Unit

功能:向控制台输出 Float16 类型数据的字符串表达。

参数:

  • f: Float16 - 待输出的 Float16 类型数据。
  • flush!: Bool - 是否清空缓存,true 清空,false 不清空,默认 false。

func print(Float32, Bool)

public func print(f: Float32, flush!: Bool = false): Unit

功能:向控制台输出 Float32 类型数据的字符串表达。

参数:

  • f: Float32 - 待输出的 Float32 类型数据。
  • flush!: Bool - 是否清空缓存,true 清空,false 不清空,默认 false。

func print(Float64, Bool)

public func print(f: Float64, flush!: Bool = false): Unit

功能:向控制台输出 Float64 类型数据的字符串表达。

参数:

  • f: Float64 - 待输出的 Float64 类型数据。
  • flush!: Bool - 是否清空缓存,true 清空,false 不清空,默认 false。

func print(Int16, Bool)

public func print(i: Int16, flush!: Bool = false): Unit

功能:向控制台输出 Int16 类型数据的字符串表达。

参数:

  • i: Int16 - 待输出的 Int16 类型数据。
  • flush!: Bool - 是否清空缓存,true 清空,false 不清空,默认 false。

func print(Int32, Bool)

public func print(i: Int32, flush!: Bool = false): Unit

功能:向控制台输出 Int32 类型数据的字符串表达。

参数:

  • i: Int32 - 待输出的 Int32 类型数据。
  • flush!: Bool - 是否清空缓存,true 清空,false 不清空,默认 false。

func print(Int64, Bool)

public func print(i: Int64, flush!: Bool = false): Unit

功能:向控制台输出 Int64 类型数据的字符串表达。

参数:

  • i: Int64 - 待输出的 Int64 类型数据。
  • flush!: Bool - 是否清空缓存,true 清空,false 不清空,默认 false。

func print(Int8, Bool)

public func print(i: Int8, flush!: Bool = false): Unit

功能:向控制台输出 Int8 类型数据的字符串表达。

参数:

  • i: Int8 - 待输出的 Int8 类型数据。
  • flush!: Bool - 是否清空缓存,true 清空,false 不清空,默认 false。

func print(Rune, Bool)

public func print(c: Rune, flush!: Bool = false): Unit

功能:向控制台输出 Rune 类型数据的字符串表达。

参数:

  • c: Rune - 待输出的 Rune 类型数据。
  • flush!: Bool - 是否清空缓存,true 清空,false 不清空,默认 false。

func print(String, Bool)

public func print(str: String, flush!: Bool = false): Unit

功能:向控制台输出指定字符串。

参数:

  • str: String - 待输出的字符串。
  • flush!: Bool - 是否清空缓存,true 清空,false 不清空,默认 false。

func print(UInt16, Bool)

public func print(i: UInt16, flush!: Bool = false): Unit

功能:向控制台输出 UInt16 类型数据的字符串表达。

参数:

  • i: UInt16 - 待输出的 UInt16 类型数据。
  • flush!: Bool - 是否清空缓存,true 清空,false 不清空,默认 false。

func print(UInt32, Bool)

public func print(i: UInt32, flush!: Bool = false): Unit

功能:向控制台输出 UInt32 类型数据的字符串表达。

参数:

  • i: UInt32 - 待输出的 UInt32 类型数据。
  • flush!: Bool - 是否清空缓存,true 清空,false 不清空,默认 false。

func print(UInt64, Bool)

public func print(i: UInt64, flush!: Bool = false): Unit

功能:向控制台输出 UInt64 类型数据的字符串表达。

参数:

  • i: UInt64 - 待输出的 UInt64 类型数据。
  • flush!: Bool - 是否清空缓存,true 清空,false 不清空,默认 false。

func print(UInt8, Bool)

public func print(i: UInt8, flush!: Bool = false): Unit

功能:向控制台输出 UInt8 类型数据的字符串表达。

参数:

  • i: UInt8 - 待输出的 UInt8 类型数据。
  • flush!: Bool - 是否清空缓存,true 清空,false 不清空,默认 false。

func print<T>(T, Bool) where T <: ToString

public func print<T>(arg: T, flush!: Bool = false): Unit where T <: ToString

功能:向控制台输出 T 类型实例的字符串表示。

参数:

  • arg: T - 待输出的数据,支持实现了 ToString 接口的类型。
  • flush!: Bool - 是否清空缓存,true 清空,false 不清空,默认 false。

func println()

public func println(): Unit

功能:向标准输出(stdout)输出换行符。

func println(Bool)

public func println(b: Bool): Unit

功能:向控制台输出 Bool 类型数据的字符串表达,末尾添加换行。

参数:

  • b: Bool - 待输出的 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 类型数据的字符串表达,末尾添加换行。

参数:

  • i: Int8 - 待输出的 Int8 类型数据。

func println(Rune)

public func println(c: Rune): Unit

功能:向控制台输出 Rune 类型数据的字符串表达,末尾添加换行。

参数:

  • c: Rune - 待输出的 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 实例的内存地址是否相同。

参数:

返回值:

  • Bool - 如果两个 Object 实例的内存地址相同,返回 true,否则返回 false。

func releaseArrayRawData<T>(CPointerHandle<T>) where T <: CType

public unsafe func releaseArrayRawData<T>(handle: CPointerHandle<T>): Unit where T <: CType

功能:释放原始指针实例,该实例通过 acquireArrayRawData 获取。

参数:

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 类型实例。