函数

func dumpHeapData(Path)

public func dumpHeapData(path: Path): Unit

功能：生成堆内存快照信息，写入指定路径的文件。

参数：

  • path: Path - 生成堆内存快照文件的文件路径。

异常：

  • MemoryInfoException - 生成堆内存快照失败时，抛出此异常。

func GC(Bool) (deprecated)

public func GC(heavy!: Bool = false): Unit

功能：执行 GC。

注意

未来版本即将废弃，使用gc 替代。

参数：

  • heavy!: Bool - GC 执行程度，如果为 true，执行会慢，内存收集的多一些，默认值为 false。

func gc(Bool)

public func gc(heavy!: Bool = false): Unit

功能：执行 gc。

参数：

  • heavy!: Bool - gc 执行程度，如果为 true，执行会慢，内存收集的多一些，默认值为 false。

func getAllocatedHeapSize()

public func getAllocatedHeapSize(): Int64

功能：获取仓颉堆已被使用的大小，单位为 byte。

返回值：

  • Int64 - 仓颉堆已被使用的大小，单位为 byte。

func getBlockingThreadCount()

public func getBlockingThreadCount(): Int64

功能：获取阻塞的仓颉线程数。

返回值：

  • Int64 - 阻塞的仓颉线程数。

func getGCCount()

public func getGCCount(): Int64

功能：获取触发 GC 的次数。

返回值：

  • Int64 - 触发 GC 的次数。

func getGCFreedSize()

public func getGCFreedSize(): Int64

功能：获取触发 GC 后，成功回收的内存，单位为 byte。

返回值：

  • Int64 - 触发 GC 后，成功回收的内存，单位为 byte。

func getGCTime()

public func getGCTime(): Int64

功能：获取触发的 GC 总耗时，单位为 us。

返回值：

  • Int64 - 触发的 GC 总耗时，单位为 us。

func getMaxHeapSize()

public func getMaxHeapSize(): Int64

功能：获取仓颉堆可以使用的最大值，单位为 byte。

返回值：

  • Int64 - 仓颉堆可以使用的最大值，单位为 byte。

func getNativeThreadCount()

public func getNativeThreadCount(): Int64

功能：获取物理线程数。

返回值：

  • Int64 - 物理线程数。

func getProcessorCount()

public func getProcessorCount(): Int64

功能：获取处理器数量。

返回值：

  • Int64 - 处理器数量。

func getThreadCount()

public func getThreadCount(): Int64

功能：获取仓颉当前的线程数量。

返回值：

  • Int64 - 仓颉当前的线程数量。

func getUsedHeapSize()

public func getUsedHeapSize(): Int64

功能：在 Linux 平台下获取仓颉堆实际占用的物理内存大小, 单位为 byte。在 Windows 及 macOs 平台下获取仓颉进程实际占用的物理内存大小, 单位为 byte。

返回值：

  • Int64 - 仓颉堆或仓颉进程实际占用的物理内存大小，单位为 byte。

func SetGCThreshold(UInt64) (deprecated)

public func SetGCThreshold(value: UInt64): Unit

功能：修改用户期望触发 GC 的内存阈值，当仓颉堆大小超过该值时，触发 GC，单位为 KB。

注意

未来版本即将废弃，使用setGCThreshold(UInt64) 替代。

参数：

  • value: UInt64 - 用户期望触发 GC 的内存阈值。

示例： 设置用户期望的 GC 的内存阈值为 2MB。

import std.runtime.*
main() {
  SetGCThreshold(2048)
}

func setGCThreshold(UInt64)

public func setGCThreshold(value: UInt64): Unit

功能：修改用户期望触发 gc 的内存阈值，当仓颉堆大小超过该值时，触发 gc，单位为 KB。

参数：

  • value: UInt64 - 用户期望触发 gc 的内存阈值。

示例： 设置用户期望的 gc 的内存阈值为 2MB。

import std.runtime.*
main() {
  setGCThreshold(2048)
}

func startCPUProfiling()

public func startCPUProfiling(): Unit

功能：启动 CPU profiler 跟踪。

异常：

func stopCPUProfiling(Path)

public func stopCPUProfiling(path: Path): Unit

功能：停止CPU profiler 跟踪，并将记录写入指定路径的文件。

参数：

  • path: Path - 生成记录文件的文件路径。

异常：