内置类型

Bool

功能：表示布尔类型，有 true 和 false 两种取值。

extend Bool <: Equatable<Bool>

extend Bool <: Equatable<Bool>

功能：为 Bool 类型扩展 Equatable<Bool> 接口，支持判等操作。

extend Bool <: Hashable

extend Bool <: Hashable

功能：为 Bool 类型扩展 Hashable 接口，支持计算哈希值。

func hashCode()

public func hashCode(): Int64

功能：获取哈希值。

返回值：

extend Bool <: ToString

extend Bool <: ToString

功能：为 Bool 类型其扩展 ToString 接口，实现向 String 类型的转换。

func toString()

public func toString(): String

功能：将 Bool 值转换为可输出的字符串。

返回值：

  • String - 转化后的字符串。

CPointer<T>

功能：表示 T 类型实例的指针，在与 C 语言互操作的场景下使用，对应 C 语言的 T*。

其中 T 必须满足 CType 约束。

CPointer 类型必须满足：

  • 大小和对齐与平台相关。
  • 对它做加减法算术运算、读写内存，是需要在 unsafe 上下文操作的。
  • CPointer<T1> 可以在 unsafe 上下文中使用类型强制转换，变成 CPointer<T2> 类型。

extend<T> CPointer<T>

extend<T> CPointer<T>

功能：为 CPointer<T> 扩展一些必要的指针使用相关接口，包含判空、读写数据等接口。

其中泛型 T 为指针类型，其满足 CType 约束。对 CPointer 做运算需要在 unsafe 上下文中进行。

func asResource()

public func asResource(): CPointerResource<T>

功能：获取该指针 CPointerResource 实例，后者可以在 try-with-resource 语法上下文中实现内容自动释放。

返回值：

func isNotNull()

public func isNotNull(): Bool

功能：判断指针是否不为空。

返回值：

  • Bool - 如果不为空返回 true，否则返回 false。

func isNull()

public func isNull(): Bool

功能：判断指针是否为空。

返回值：

  • Bool - 如果为空返回 true，否则返回 false。

func read()

public unsafe func read(): T

功能：读取第一个数据，该接口需要用户保证指针的合法性，否则发生未定义行为。

返回值：

  • T - 该对象类型的第一个数据。

func read(Int64)

public unsafe func read(idx: Int64): T

功能：根据下标读取对应的数据，该接口需要用户保证指针的合法性，否则发生未定义行为。

参数：

  • idx: Int64 - 要获取数据的下标。

返回值：

  • T - 输入下标对应的数据。

func toUIntNative()

public func toUIntNative(): UIntNative

功能：获取该指针的整型形式。

返回值：

func write(Int64, T)

public unsafe func write(idx: Int64, value: T): Unit

功能：在指定下标位置写入一个数据，该接口需要用户保证指针的合法性，否则发生未定义行为。

参数：

  • idx: Int64 - 指定的下标位置。
  • value: T - 写入的数据。

func write(T)

public unsafe func write(value: T): Unit

功能：写入一个数据，该数据总是在第一个，该接口需要用户保证指针的合法性，否则发生未定义行为。

参数：

  • value: T - 要写入的数据。

operator func +(Int64)

public unsafe operator func +(offset: Int64): CPointer<T>

功能：CPointer 对象指针后移，同 C 语言的指针加法操作。

参数：

  • offset: Int64 - 偏移量。

返回值：

  • CPointer<T> - 返回偏移后的指针。

operator func -(Int64)

public unsafe operator func -(offset: Int64): CPointer<T>

功能：CPointer 对象指针前移，同 C 语言的指针减法操作。

参数：

  • offset: Int64 - 偏移量。

返回值：

  • CPointer<T> - 返回偏移后的指针。

CString

功能：表示 C 风格字符串，在与 C 语言互操作的场景下使用。

可以通过 CString 的构造函数或 LibC 的 mallocCString 创建 C 风格字符串，如需在仓颉端释放，则调用 LibC 的 free 方法。

extend CString <: ToString

extend CString <: ToString

功能：为 CString 类型扩展一些字符串指针常用方法，包括判空、获取长度、判等、获取子串等。

func asResource()

public func asResource(): CStringResource

功能：获取当前 CString 实例对应的 CStringResource C 字符串资源类型实例。

CStringResource 实现了 Resource 接口，可以在 try-with-resource 语法上下文中实现资源自动释放。

返回值：

func compare(CString)

public func compare(str: CString): Int32

功能：按字典序比较两个字符串，同 C 语言中的 strcmp。

参数：

  • str: CString - 比较的目标字符串。

返回值：

  • Int32 - 两者相等返回 0，如果当前字符串比参数 str 小，返回 -1，否则返回 1。

异常：

  • Exception - 如果被比较的两个 CString 中存在空指针，抛出异常。

func endsWith(CString)

public func endsWith(suffix: CString): Bool

功能：判断字符串是否包含指定后缀。

参数：

  • suffix: CString - 匹配的目标后缀字符串。

返回值：

  • Bool - 如果该字符串包含 suffix 后缀，返回 true，如果该字符串不包含 suffix 后缀，返回 false，特别地，如果原字符串或者 suffix 后缀字符串指针为空，均返回 false。

func equals(CString)

public func equals(rhs: CString): Bool

功能：判断两个字符串是否相等。

参数：

  • rhs: CString - 比较的目标字符串。

返回值：

  • Bool - 如果两个字符串相等，返回 true，否则返回 false。

func equalsLower(CString)

public func equalsLower(rhs: CString): Bool

功能：判断两个字符串是否相等，忽略大小写。

参数：

  • rhs: CString - 匹配的目标字符串。

返回值：

  • Bool - 如果两个字符串忽略大小写相等，返回 true，否则返回 false。

func isEmpty()

public func isEmpty(): Bool

功能：判断字符串是否为空字符串。

返回值：

  • Bool - 如果为空字符串或字符串指针为空，返回 true，否则返回 false。

func isNotEmpty()

public func isNotEmpty(): Bool

功能：判断字符串是否不为空字符串。

返回值：

  • Bool - 如果不为空字符串，返回 true，如果字符串指针为空，返回 false。

func isNull()

public func isNull(): Bool

功能：判断字符串指针是否为空。

返回值：

  • Bool - 如果字符串指针为空，返回 true，否则返回 false。

func size()

public func size(): Int64

功能：返回该字符串长度，同 C 语言中的 strlen。

返回值：

  • Int64 - 字符串长度。

func startsWith(CString)

public func startsWith(prefix: CString): Bool

功能：判断字符串是否包含指定前缀。

参数：

  • prefix: CString - 匹配的目标前缀字符串。

返回值：

  • Bool - 如果该字符串包含 prefix 前缀，返回 true，如果该字符串不包含 prefix 前缀，返回 false，特别地，如果原字符串或者 prefix 前缀字符串指针为空，均返回 false。

func subCString(UIntNative)

public func subCString(beginIndex: UIntNative): CString

功能：截取指定位置开始至字符串结束的子串。

注意：

  1. 该接口返回为字符串的副本，返回的子串使用完后需要手动 free。
  2. 如果 beginIndex 与字符串长度相等，将返回空指针。

参数：

  • beginIndex: UIntNative - 截取的起始位置，取值范围为 [0, this.size()]。

返回值：

异常：

func subCString(UIntNative, UIntNative)

public func subCString(beginIndex: UIntNative, subLen: UIntNative): CString

功能：截取字符串的子串，指定起始位置和截取长度。

如果截取的末尾位置超出字符串长度，截取至字符串末尾。

注意：

  1. 该接口返回为字符串的副本，返回的子串使用完后需要手动 free。
  2. 如果 beginIndex 等于于字符串长度，或 subLen 等于 0，返回空指针。

参数：

  • beginIndex: UIntNative - 截取的起始位置，取值范围为 [0, this.size()]。
  • subLen: UIntNative - 截取长度，取值范围为 [0, UIntNative.Max]。

返回值：

异常：

func toString()

public func toString(): String

功能：将 CString 类型转为仓颉的 String 类型。

返回值：

  • String - 转换后的字符串。

Float16

功能：表示 16 位浮点数，符合 IEEE 754 中的半精度格式（binary16）。

extend Float16 <: Comparable<Float16>

extend Float16 <: Comparable<Float16>

功能：为 Float16 类型扩展 Comparable<Float16> 接口，支持比较操作。

func compare(Float16)

public func compare(rhs: Float16): Ordering

功能：判断当前 Float16 值与指定 Float16 值的大小关系。

参数：

返回值：

extend Float16 <: FloatToBits

extend Float16 <: FloatToBits

功能：为 Float16 实现 FloatToBits 接口，支持与 UInt16 互相转换。

static func fromBits(UInt16)

public static func fromBits(bits: UInt16): Float16

功能：将指定的 UInt16 数转换为 Float16 数。

参数：

  • bits: UInt16 - 要转换的数字。

返回值：

  • Float16 - 转换结果，其位与参数 bits 值相同。

示例：

import std.unittest.*
import std.unittest.testmacro.*

main() {
    let v = Float16.fromBits(0x4A40)
    @Assert(v, 12.5)
}

func toBits()

public func toBits(): UInt16

功能：将指定的 Float16 数转换为以位表示的对应 UInt16 数。

返回值：

  • UInt16 - 转换结果，其值与 Float16 的位表示相同。

示例：

import std.unittest.*
import std.unittest.testmacro.*

main() {
    @Assert(12.5f16.toBits(), 0x4A40)
}

extend Float16 <: Hashable

extend Float16 <: Hashable

功能：为 Float16 类型扩展 Hashable 接口，支持计算哈希值。

func hashCode()

public func hashCode(): Int64

功能：获取哈希值。

返回值：

extend Float16 <: ToString

extend Float16 <: ToString

功能：为 Float16 类型其扩展 ToString 接口，实现向 String 类型的转换。

默认保留 6 位小数，如需其他精度 String 请参考 Formatter 扩展。

func toString()

public func toString(): String

功能：将 Float16 值转换为可输出的字符串。

返回值：

  • String - 转化后的字符串。

Float32

功能：表示 32 位浮点数，符合 IEEE 754 中的单精度格式（binary32）。

extend Float32 <: Comparable<Float32>

extend Float32 <: Comparable<Float32>

功能：为 Float32 类型扩展 Comparable<Float32> 接口，支持比较操作。

func compare(Float32)

public func compare(rhs: Float32): Ordering

功能：判断当前 Float32 值与指定 Float32 值的大小关系。

参数：

返回值：

extend Float32 <: FloatToBits

extend Float32 <: FloatToBits

功能：为 Float32 实现 FloatToBits 接口，支持与 UInt32 互相转换。

static func fromBits(UInt32)

public static func fromBits(bits: UInt32): Float32

功能：将指定的 UInt32 数转换为 Float32 数。

参数：

  • bits: UInt32 - 要转换的数字。

返回值：

  • Float32 - 转换结果，其位与参数 bits 值相同。

示例：

import std.unittest.*
import std.unittest.testmacro.*

main() {
    let v = Float32.fromBits(0x41480000)
    @Assert(v, 12.5)
}

func toBits()

public func toBits(): UInt32

功能：将指定的 Float32 数转换为以位表示的对应 UInt32 数。

返回值：

  • UInt32 - 转换结果，其值与 Float32 的位表示相同。

示例：

import std.unittest.*
import std.unittest.testmacro.*

main() {
    @Assert(12.5f32.toBits(), 0x41480000)
}

extend Float32 <: Hashable

extend Float32 <: Hashable

功能：为 Float32 类型扩展 Hashable 接口，支持计算哈希值。

func hashCode()

public func hashCode(): Int64

功能：获取哈希值。

返回值：

extend Float32 <: ToString

extend Float32 <: ToString

功能：为 Float32 类型其扩展 ToString 接口，实现向 String 类型的转换。

默认保留 6 位小数，如需其他精度 String 请参考 Formatter 扩展。

func toString()

public func toString(): String

功能：将 Float32 值转换为可输出的字符串。

返回值：

  • String - 转化后的字符串。

Float64

功能：表示 64 位浮点数，符合 IEEE 754 中的双精度格式（binary64）。

extend Float64 <: Comparable<Float64>

extend Float64 <: Comparable<Float64>

功能：为 Float64 类型扩展 Comparable<Float64> 接口，支持比较操作。

func compare(Float64)

public func compare(rhs: Float64): Ordering

功能：判断当前 Float64 值与指定 Float64 值的大小关系。

参数：

返回值：

extend Float64 <: FloatToBits

extend Float64 <: FloatToBits

功能：为 Float64 实现 FloatToBits 接口，支持与 UInt64 互相转换。

static func fromBits(UInt64)

public static func fromBits(bits: UInt64): Float64

功能：将指定的 UInt64 数转换为 Float64 数。

参数：

  • bits: UInt64 - 要转换的数字。

返回值：

  • Float64 - 转换结果，其位与参数 bits 值相同。

示例：

import std.unittest.*
import std.unittest.testmacro.*

main() {
    let v = Float64.fromBits(0x4029000000000000)
    @Assert(v, 12.5)
}

func toBits()

public func toBits(): UInt64

功能：将指定的 Float64 数转换为以位表示的对应 UInt64 数。

返回值：

  • UInt64 - 转换结果，其值与 Float64 的位表示相同。

示例：

import std.unittest.*
import std.unittest.testmacro.*

main() {
    @Assert(12.5f64.toBits(), 0x4029000000000000)
}

extend Float64 <: Hashable

extend Float64 <: Hashable

功能：为 Float64 类型扩展 Hashable 接口，支持计算哈希值。

func hashCode()

public func hashCode(): Int64

功能：获取哈希值。

返回值：

extend Float64 <: ToString

extend Float64 <: ToString

功能：为 Float64 类型其扩展 ToString 接口，实现向 String 类型的转换。

默认保留 6 位小数，如需其他精度 String 请参考 Formatter 扩展。

func toString()

public func toString(): String

功能：将 Float64 值转换为可输出的字符串。

返回值：

  • String - 转化后的字符串。

Int16

功能：表示 16 位有符号整型，表示范围为 [-2^{15}, 2^{15} - 1]。

extend Int16 <: Comparable<Int16>

extend Int16 <: Comparable<Int16>

功能：为 Int16 类型扩展 Comparable<Int16> 接口，支持比较操作。

func compare(Int16)

public func compare(rhs: Int16): Ordering

功能：判断当前 Int16 值与指定 Int16 值的大小关系。

参数：

返回值：

extend Int16 <: Countable<Int16>

extend Int16 <: Countable<Int16>

功能：为 Int16 类型扩展 Countable<Int16> 接口，支持计数操作。

func next(Int64)

public func next(right: Int64): Int16

功能：获取当前 Int16 值往右数 right 后所到位置的 Int16 值。

参数：

  • right: Int64 - 往右数的个数。

返回值：

  • Int16 - 往右数 right 后所到位置的 Int16 值。

func position()

public func position(): Int64

功能：获取当前 Int16 值的位置信息，即将该 Int16 转换为 Int64 值。

返回值：

extend Int16 <: Hashable

extend Int16 <: Hashable

功能：为 Int16 类型扩展 Hashable 接口，支持计算哈希值。

func hashCode()

public func hashCode(): Int64

功能：获取哈希值。

返回值：

extend Int16 <: ToString

extend Int16 <: ToString

功能：这里为 Int16 类型扩展 ToString 接口，实现向 String 类型的转换。

func toString()

public func toString(): String

功能：将 Int16 值转换为可输出的字符串。

返回值：

  • String - 转化后的字符串。

Int32

功能：表示 32 位有符号整型，表示范围为 [-2^{31}, 2^{31} - 1]。

extend Int32 <: Comparable<Int32>

extend Int32 <: Comparable<Int32>

功能：为 Int32 类型扩展 Comparable<Int32> 接口，支持比较操作。

func compare(Int32)

public func compare(rhs: Int32): Ordering

功能：判断当前 Int32 值与指定 Int32 值的大小关系。

参数：

返回值：

extend Int32 <: Countable<Int32>

extend Int32 <: Countable<Int32>

功能：为 Int32 类型扩展 Countable<Int32> 接口，支持计数操作。

func next(Int64)

public func next(right: Int64): Int32

功能：获取当前 Int32 值往右数 right 后所到位置的 Int32 值。

参数：

  • right: Int64 - 往右数的个数。

返回值：

  • Int32 - 往右数 right 后所到位置的 Int32 值。

func position()

public func position(): Int64

功能：获取当前 Int32 值的位置信息，即将该 Int32 转换为 Int64 值。

返回值：

extend Int32 <: Hashable

extend Int32 <: Hashable

功能：为 Int32 类型扩展 Hashable 接口，支持计算哈希值。

func hashCode()

public func hashCode(): Int64

功能：获取哈希值。

返回值：

extend Int32 <: ToString

extend Int32 <: ToString

功能：这里为 Int32 类型扩展 ToString 接口，实现向 String 类型的转换。

func toString()

public func toString(): String

功能：将 Int32 值转换为可输出的字符串。

返回值：

  • String - 转化后的字符串。

Int64

功能：表示 64 位有符号整型，表示范围为 [-2^{63}, 2^{63} - 1]。

extend Int64 <: Comparable<Int64>

extend Int64 <: Comparable<Int64>

功能：为 Int64 类型扩展 Comparable<Int64> 接口，支持比较操作。

func compare(Int64)

public func compare(rhs: Int64): Ordering

功能：判断当前 Int64 值与指定 Int64 值的大小关系。

参数：

返回值：

extend Int64 <: Countable<Int64>

extend Int64 <: Countable<Int64>

功能：为 Int64 类型扩展 Countable<Int64> 接口，支持计数操作。

func next(Int64)

public func next(right: Int64): Int64

功能：获取当前 Int64 值往右数 right 后所到位置的 Int64 值。

参数：

  • right: Int64 - 往右数的个数。

返回值：

  • Int64 - 往右数 right 后所到位置的 Int64 值。

func position()

public func position(): Int64

功能：获取当前 Int64 值的位置信息，即返回该 Int64 值本身。

返回值：

extend Int64 <: Hashable

extend Int64 <: Hashable

功能：为 Int64 类型扩展 Hashable 接口，支持计算哈希值。

func hashCode()

public func hashCode(): Int64

功能：获取哈希值。

返回值：

extend Int64 <: ToString

extend Int64 <: ToString

功能：这里为 Int64 类型扩展 ToString 接口，实现向 String 类型的转换。

func toString()

public func toString(): String

功能：将 Int64 值转换为可输出的字符串。

返回值：

  • String - 转化后的字符串。

Int8

功能：表示 8 位有符号整型，表示范围为 [-2^7, 2^7 - 1]。

extend Int8 <: Comparable<Int8>

extend Int8 <: Comparable<Int8>

功能：为 Int8 类型扩展 Comparable<Int8> 接口，支持比较操作。

func compare(Int8)

public func compare(rhs: Int8): Ordering

功能：判断当前 Int8 值与指定 Int8 值的大小关系。

参数：

  • rhs: Int8 - 待比较的另一个 Int8 值。

返回值：

extend Int8 <: Countable<Int8>

extend Int8 <: Countable<Int8>

功能：为 Int8 类型扩展 Countable<Int8> 接口，支持计数操作。

func next(Int64)

public func next(right: Int64): Int8

功能：获取当前 Int8 值往右数 right 后所到位置的 Int8 值。

参数：

  • right: Int64 - 往右数的个数。

返回值：

  • Int8 - 往右数 right 后所到位置的 Int8 值。

func position()

public func position(): Int64

功能：获取当前 Int8 值的位置信息，即将该 Int8 转换为 Int64 值。

返回值：

extend Int8 <: Hashable

extend Int8 <: Hashable

功能：为 Int8 类型扩展 Hashable 接口，支持计算哈希值。

func hashCode()

public func hashCode(): Int64

功能：获取哈希值。

返回值：

extend Int8 <: ToString

extend Int8 <: ToString

功能：这里为 Int8 类型扩展 ToString 接口，实现向 String 类型的转换。

func toString()

public func toString(): String

功能：将 Int8 值转换为可输出的字符串。

返回值：

  • String - 转化后的字符串。

IntNative

功能：表示平台相关的有符号整型，其长度与当前系统的位宽一致。

extend IntNative <: Comparable<IntNative>

extend IntNative <: Comparable<IntNative>

功能：为 IntNative 类型扩展 Comparable<IntNative> 接口，支持比较操作。

func compare(IntNative)

public func compare(rhs: IntNative): Ordering

功能：判断当前 IntNative 值与指定 IntNative 值的大小关系。

参数：

返回值：

extend IntNative <: Countable<IntNative>

extend IntNative <: Countable<IntNative>

功能：为 IntNative 类型扩展 Countable<IntNative> 接口，支持计数操作。

func next(Int64)

public func next(right: Int64): IntNative

功能：获取当前 IntNative 值往右数 right 后所到位置的 IntNative 值。

参数：

  • right: Int64 - 往右数的个数。

返回值：

func position()

public func position(): Int64

功能：获取当前 IntNative 值的位置信息，即将该 IntNative 转换为 Int64 值。

返回值：

extend IntNative <: Hashable

extend IntNative <: Hashable

功能：为 IntNative 类型扩展 Hashable 接口，支持计算哈希值。

func hashCode()

public func hashCode(): Int64

功能：获取哈希值。

返回值：

extend IntNative <: ToString

extend IntNative <: ToString

功能：这里为 IntNative 类型扩展 ToString 接口，实现向 String 类型的转换。

func toString()

public func toString(): String

功能：将 IntNative 值转换为可输出的字符串。

返回值：

  • String - 转化后的字符串。

Rune

功能：表示 unicode 字符集中的字符。

表示范围为 Unicode scalar value，即从 \u{0000} 到 \u{D7FF}，以及从 \u{E000} 到 \u{10FFF} 的字符。

extend Rune <: RuneExtension

extend Rune <: RuneExtension

功能：为 Rune 类型实现一系列扩展方法，主要为在 Ascii 字符集范围内的一些字符判断、转换等操作。

static func fromUtf8(Array<UInt8>, Int64)

public static func fromUtf8(arr: Array<UInt8>, index: Int64): (Rune, Int64)

功能：将字节数组中的指定元素，根据 UTF-8 编码规则转换成字符，并告知字符占用字节长度。

参数：

  • arr: Array<UInt8> - 待转换字节所在的字节数组。
  • index: Int64 - 待转换字节在数组中的下标。

返回值：

  • (Rune, Int64) - 转换得到的字符，以及该字符占用的字节长度。

static func getPreviousFromUtf8(Array<UInt8>, Int64)

public static func getPreviousFromUtf8(arr: Array<UInt8>, index: Int64): (Rune, Int64)

功能：获取字节数组中指定索引对应的字节所在的 UTF-8 编码字符，同时返回该字符首位字节码在数组中的索引。

当指定了一个索引，那么函数会找到数组对应索引位置并且根据 UTF-8 规则，查看该字节码是否是字符的首位字节码，如果不是就继续向前遍历，直到该字节码是首位字节码，然后利用字节码序列找到对应的字符。

参数：

  • arr: Array<UInt8> - 待从中获取字符的字节数组。
  • index: Int64 - 待查找字符在数组中的索引。

返回值：

  • (Rune, Int64) - 找到的字符，以及该字符首位字节码在数组中的索引。

异常：

  • IllegalArgumentException - 如果找不到对应首位字节码，即指定字节所在位置的字节不符合 UTF-8 编码，抛出异常。

static func intoUtf8Array(Rune, Array<UInt8>, Int64)

public static func intoUtf8Array(c: Rune, arr: Array<UInt8>, index: Int64): Int64

功能：该函数会把字符转成字节码序列然后覆盖 Array 数组内指定位置的字节码。

参数：

  • c: Rune - 待转换的字符。
  • arr: Array<UInt8> - 待覆盖的 Array 数组。
  • index: Int64 - 目标位置的起始索引。

返回值：

  • Int64 - 字符的字节码长度，例如中文是三个字节码长度。

static func utf8Size(Array<UInt8>, Int64)

public static func utf8Size(arr: Array<UInt8>, index: Int64): Int64

功能：该函数会返回字节数组指定索引位置为起始的字符占用的字节数。

在 UTF-8 编码中，ASCII 码首位字节第一位不为 1，其他长度的字符首位字节开头 1 的个数表明了该字符对应的字节码长度，该函数通过扫描首位，判断字节码长度。如果索引对应的不是首位字节码，就会抛出异常。

参数：

  • arr: Array<UInt8> - 待获取字符的字节数组。
  • index: Int64 - 指定字符的索引。

返回值：

  • Int64 - 字符的字节码长度，例如中文是三个字节码长度。

异常：

static func utf8Size(Rune)

public static func utf8Size(c: Rune): Int64

功能：返回字符对应的 UTF-8 编码的字节码长度，例如中文字符的字节码长度是 3。

参数：

  • c: Rune - 待计算 UTF-8 字节码长度的字符。

返回值：

  • Int64 - 字符的 UTF-8 字节码长度。

func isAscii()

public func isAscii(): Bool

功能：判断字符是否是 Ascii 中的字符。

返回值：

  • Bool - 如果是 Ascii 字符返回 true，否则返回 false。

func isAsciiControl()

public func isAsciiControl(): Bool

功能：判断字符是否是 Ascii 控制字符。其取值范围为 [00, 1F] 和 {7F} 的并集。

返回值：

  • Bool - 如果是 Ascii 控制字符返回 true，否则返回 false。

func isAsciiGraphic()

public func isAsciiGraphic(): Bool

功能：判断字符是否是 Ascii 图形字符。其取值范围为 [21, 7E]。

返回值：

  • Bool - 如果是 Ascii 图形字符返回 true，否则返回 false。

func isAsciiHex()

public func isAsciiHex(): Bool

功能：判断字符是否是 Ascii 十六进制字符。

返回值：

  • Bool - 如果是 Ascii 十六进制字符返回 true，否则返回 false。

func isAsciiLetter()

public func isAsciiLetter(): Bool

功能：判断字符是否是 Ascii 字母字符。

返回值：

  • Bool - 如果是 Ascii 字母字符返回 true，否则返回 false。

func isAsciiLowerCase()

public func isAsciiLowerCase(): Bool

功能：判断字符是否是 Ascii 小写字符。

返回值：

  • Bool - 如果是 Ascii 小写字符返回 true，否则返回 false。

func isAsciiNumber()

public func isAsciiNumber(): Bool

功能：判断字符是否是 Ascii 数字字符。

返回值：

  • Bool - 如果是 Ascii 数字字符返回 true，否则返回 false。

func isAsciiNumberOrLetter()

public func isAsciiNumberOrLetter(): Bool

功能：判断字符是否是 Ascii 数字或拉丁字母字符。

返回值：

  • Bool - 如果是 Ascii 数字或拉丁字母字符返回 true，否则返回 false。

func isAsciiOct()

public func isAsciiOct(): Bool

功能：判断字符是否是 Ascii 八进制字符。

返回值：

  • Bool - 如果是 Ascii 八进制字符返回 true，否则返回 false。

func isAsciiPunctuation()

public func isAsciiPunctuation(): Bool

功能：判断字符是否是 Ascii 标点符号字符。其取值范围为 [21, 2F]、[3A, 40]、[5B, 60] 和 [7B, 7E] 的并集。

返回值：

  • Bool - 如果是 Ascii 标点符号字符返回 true，否则返回 false。

func isAsciiUpperCase()

public func isAsciiUpperCase(): Bool

功能：判断字符是否是 Ascii 大写字符。

返回值：

  • Bool - 如果是 Ascii 大写字符返回 true，否则返回 false。

func isAsciiWhiteSpace()

public func isAsciiWhiteSpace(): Bool

功能：判断字符是否是 Ascii 空白字符。其取值范围为 [09, 0D] 和 {20} 的并集。

返回值：

  • Bool - 如果是 Ascii 空白字符返回 true，否则返回 false。

func toAsciiLowerCase()

public func toAsciiLowerCase(): Rune

功能：将字符转换为 Ascii 小写字符，如果无法转换则保持现状。

返回值：

  • Rune - 转换后的字符，如果无法转换则返回原来的 Rune。

func toAsciiUpperCase()

public func toAsciiUpperCase(): Rune

功能：将字符转换为 Ascii 大写字符，如果无法转换则保持现状。

返回值：

  • Rune - 转换后的字符，如果无法转换则返回原来的 Rune。

extend Rune <: Comparable<Rune>

extend Rune <: Comparable<Rune>

功能：为 Rune 类型扩展 Comparable<Rune> 接口，支持比较操作。

func compare(Rune)

public func compare(rhs: Rune): Ordering

功能：判断当前 Rune 实例与指定 Rune 实例的大小关系。

Rune 的大小关系指的是它们对应的 unicode 码点的大小关系。

参数：

  • rhs: Rune - 待比较的另一个 Rune 实例。

返回值：

extend Rune <: Countable<Rune>

extend Rune <: Countable<Rune>

功能：为 Rune 类型扩展 Countable<Rune> 接口，支持计数操作。

func next(Int64)

public func next(right: Int64): Rune

功能：获取当前 Rune 值往右数 right 后所到位置的 Rune 值。

参数：

  • right: Int64 - 往右数的个数。

返回值：

  • Rune - 往右数 right 后所到位置的 Rune 值。

异常：

func position()

public func position(): Int64

功能：获取当前 Rune 值的位置信息，即将该 Rune 转换为 Int64 值。

返回值：

extend Rune <: Hashable

extend Rune <: Hashable

功能：为 Rune 类型扩展 Hashable 接口，支持计算哈希值。

func hashCode()

public func hashCode(): Int64

功能：获取哈希值。

返回值：

extend Rune <: ToString

extend Rune <: ToString

功能：这里为 Rune 类型扩展 ToString 接口，实现向 String 类型的转换。

func toString()

public func toString(): String

功能：将 Rune 值转换为可输出的字符串。

返回值：

  • String - 转化后的字符串。

UInt16

功能：表示 16 位无符号整型，表示范围为 [0, 2^{16}]。

extend UInt16 <: Comparable<UInt16>

extend UInt16 <: Comparable<UInt16>

功能：为 UInt16 类型扩展 Comparable<UInt16> 接口，支持比较操作。

func compare(UInt16)

public func compare(rhs: UInt16): Ordering

功能：判断当前 UInt16 值与指定 UInt16 值的大小关系。

参数：

返回值：

extend UInt16 <: Countable<UInt16>

extend UInt16 <: Countable<UInt16>

功能：为 UInt16 类型扩展 Countable<UInt16> 接口，支持计数操作。

func next(Int64)

public func next(right: Int64): UInt16

功能：获取当前 UInt16 值往右数 right 后所到位置的 UInt16 值。

参数：

  • right: Int64 - 往右数的个数。

返回值：

func position()

public func position(): Int64

功能：获取当前 UInt16 值的位置信息，即将该 UInt16 转换为 Int64 值。

返回值：

extend UInt16 <: Hashable

extend UInt16 <: Hashable

功能：为 UInt16 类型扩展 Hashable 接口，支持计算哈希值。

func hashCode()

public func hashCode(): Int64

功能：获取哈希值。

返回值：

extend UInt16 <: ToString

extend UInt16 <: ToString

功能：这里为 UInt16 类型扩展 ToString 接口，实现向 String 类型的转换。

func toString()

public func toString(): String

功能：将 UInt16 值转换为可输出的字符串。

返回值：

  • String - 转化后的字符串。

UInt32

功能：表示 32 位无符号整型，表示范围为 [0, 2^{32}]。

extend UInt32 <: Comparable<UInt32>

extend UInt32 <: Comparable<UInt32>

功能：为 UInt32 类型扩展 Comparable<UInt32> 接口，支持比较操作。

func compare(UInt32)

public func compare(rhs: UInt32): Ordering

功能：判断当前 UInt32 值与指定 UInt32 值的大小关系。

参数：

返回值：

extend UInt32 <: Countable<UInt32>

extend UInt32 <: Countable<UInt32>

功能：为 UInt32 类型扩展 Countable<UInt32> 接口，支持计数操作。

func next(Int64)

public func next(right: Int64): UInt32

功能：获取当前 UInt32 值往右数 right 后所到位置的 UInt32 值。

参数：

  • right: Int64 - 往右数的个数。

返回值：

func position()

public func position(): Int64

功能：获取当前 UInt32 值的位置信息，即将该 UInt32 转换为 UInt64 值。

返回值：

extend UInt32 <: Hashable

extend UInt32 <: Hashable

功能：为 UInt32 类型扩展 Hashable 接口，支持计算哈希值。

func hashCode()

public func hashCode(): Int64

功能：获取哈希值。

返回值：

extend UInt32 <: ToString

extend UInt32 <: ToString

功能：这里为 UInt32 类型扩展 ToString 接口，实现向 String 类型的转换。

func toString()

public func toString(): String

功能：将 UInt32 值转换为可输出的字符串。

返回值：

  • String - 转化后的字符串。

UInt64

功能：表示 64 位无符号整型，表示范围为 [0, 2^{64}]。

extend UInt64 <: Comparable<UInt64>

extend UInt64 <: Comparable<UInt64>

功能：为 UInt64 类型扩展 Comparable<UInt64> 接口，支持比较操作。

func compare(UInt64)

public func compare(rhs: UInt64): Ordering

功能：判断当前 UInt64 值与指定 UInt64 值的大小关系。

参数：

返回值：

extend UInt64 <: Countable<UInt64>

extend UInt64 <: Countable<UInt64>

功能：为 UInt64 类型扩展 Countable<UInt64> 接口，支持计数操作。

func next(Int64)

public func next(right: Int64): UInt64

功能：获取当前 UInt64 值往右数 right 后所到位置的 UInt64 值。

参数：

  • right: Int64 - 往右数的个数。

返回值：

func position()

public func position(): Int64

功能：获取当前 UInt64 值的位置信息，即将该 UInt64 转换为 Int64 值。

返回值：

extend UInt64 <: Hashable

extend UInt64 <: Hashable

功能：为 UInt64 类型扩展 Hashable 接口，支持计算哈希值。

func hashCode()

public func hashCode(): Int64

功能：获取哈希值。

返回值：

extend UInt64 <: ToString

extend UInt64 <: ToString

功能：这里为 UInt64 类型扩展 ToString 接口，实现向 String 类型的转换。

func toString()

public func toString(): String

功能：将 UInt64 值转换为可输出的字符串。

返回值：

  • String - 转化后的字符串。

UInt8

功能：表示 8 位无符号整型，表示范围为 [0, 2^8]。

extend UInt8 <: Comparable<UInt8>

extend UInt8 <: Comparable<UInt8>

功能：为 UInt8 类型扩展 Comparable<UInt8> 接口，支持比较操作。

func compare(UInt8)

public func compare(rhs: UInt8): Ordering

功能：判断当前 UInt8 值与指定 UInt8 值的大小关系。

参数：

返回值：

extend UInt8 <: Countable<UInt8>

extend UInt8 <: Countable<UInt8>

功能：为 UInt8 类型扩展 Countable<UInt8> 接口，支持计数操作。

func next(Int64)

public func next(right: Int64): UInt8

功能：获取当前 UInt8 值往右数 right 后所到位置的 UInt8 值。

参数：

  • right: Int64 - 往右数的个数。

返回值：

  • UInt8 - 往右数 right 后所到位置的 UInt8 值。

func position()

public func position(): Int64

功能：获取当前 UInt8 值的位置信息，即将该 UInt8 转换为 Int64 值。

返回值：

extend UInt8 <: Hashable

extend UInt8 <: Hashable

功能：为 UInt8 类型扩展 Hashable 接口，支持计算哈希值。

func hashCode()

public func hashCode(): Int64

功能：获取哈希值。

返回值：

extend UInt8 <: ToString

extend UInt8 <: ToString

功能：这里为 UInt8 类型扩展 ToString 接口，实现向 String 类型的转换。

func toString()

public func toString(): String

功能：将 UInt8 值转换为可输出的字符串。

返回值：

  • String - 转化后的字符串。

UIntNative

功能：表示平台相关的无符号整型，其长度与当前系统的位宽一致。

extend UIntNative <: Comparable<UIntNative>

extend UIntNative <: Comparable<UIntNative>

功能：为 UIntNative 类型扩展 Comparable<UIntNative> 接口，支持比较操作。

func compare(UIntNative)

public func compare(rhs: UIntNative): Ordering

功能：判断当前 UIntNative 值与指定 UIntNative 值的大小关系。

参数：

返回值：

extend UIntNative <: Countable

extend UIntNative <: Countable<UIntNative>

功能：为 UIntNative 类型扩展 Countable<UIntNative> 接口，支持计数操作。

func next(Int64)

public func next(right: Int64): UIntNative

功能：获取当前 UIntNative 值往右数 right 后所到位置的 UIntNative 值。

参数：

  • right: Int64 - 往右数的个数。

返回值：

func position()

public func position(): Int64

功能：获取当前 UIntNative 值的位置信息，即将该 UIntNative 转换为 Int64 值。

返回值：

extend UIntNative <: Hashable

extend UIntNative <: Hashable

功能：为 UIntNative 类型扩展 Hashable 接口，支持计算哈希值。

func hashCode()

public func hashCode(): Int64

功能：获取哈希值。

返回值：

extend UIntNative <: ToString

extend UIntNative <: ToString

功能：这里为 UIntNative 类型扩展 ToString 接口，实现向 String 类型的转换。

func toString()

public func toString(): String

功能：将 UIntNative 值转换为可输出的字符串。

返回值：

  • String - 转化后的字符串。

Unit

功能：表示仓颉语言中只关心副作用而不关心值的表达式的类型。

例如，print 函数、赋值表达式、复合赋值表达式、自增和自减表达式、循环表达式，它们的类型都是 Unit。

Unit 类型只有一个值，也是它的字面量：()。除了赋值、判等和判不等外，Unit 类型不支持其他操作。

extend Unit <: Equatable<Unit>

extend Unit <: Equatable<Unit>

功能：为 Unit 类型扩展 Equatable<Unit> 接口。

extend Unit <: Hashable

extend Unit <: Hashable

功能：为 Unit 类型扩展 Hashable 接口，支持计算哈希值。

func hashCode()

public func hashCode(): Int64

功能：获取哈希值，Unit 的哈希值为 0。

返回值：

extend Unit <: ToString

extend Unit <: ToString

功能：为 Unit 类型其扩展 ToString 接口，实现向 String 类型的转换。

Unit 的字符串表示是 "()"。

func toString()

public func toString(): String

功能：将 Unit 值转换为可输出的字符串。

返回值：

  • String - 转化后的字符串。