内置类型
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
功能:获取哈希值。
返回值:
- 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
语法上下文中实现内容自动释放。
返回值:
- CPointerResource<T> - 当前指针对应的 CPointerResource 实例。
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
功能:获取该指针的整型形式。
返回值:
- 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
语法上下文中实现资源自动释放。
返回值:
- CStringResource - 对应的 CStringResource C 字符串资源类型实例。
func compare(CString)
public func compare(str: CString): Int32
功能:按字典序比较两个字符串,同 C 语言中的 strcmp
。
参数:
- str: CString - 比较的目标字符串。
返回值:
- Int32 - 两者相等返回 0,如果当前字符串比参数 str 小,返回 -1,否则返回 1。
异常:
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 getChars()
public func getChars(): CPointer<UInt8>
功能:获取该字符串的指针。
返回值:
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
功能:截取指定位置开始至字符串结束的子串。
注意:
- 该接口返回为字符串的副本,返回的子串使用完后需要手动 free。
- 如果 beginIndex 与字符串长度相等,将返回空指针。
参数:
- beginIndex: UIntNative - 截取的起始位置,取值范围为 [0, this.size()]。
返回值:
- CString - 截取的子串。
异常:
- IndexOutOfBoundsException - 如果 beginIndex 大于字符串长度,抛出异常。
- IllegalMemoryException - 如果内存申请失败或内存拷贝失败时,抛出异常。
func subCString(UIntNative, UIntNative)
public func subCString(beginIndex: UIntNative, subLen: UIntNative): CString
功能:截取字符串的子串,指定起始位置和截取长度。
如果截取的末尾位置超出字符串长度,截取至字符串末尾。
注意:
- 该接口返回为字符串的副本,返回的子串使用完后需要手动 free。
- 如果 beginIndex 等于于字符串长度,或 subLen 等于 0,返回空指针。
参数:
- beginIndex: UIntNative - 截取的起始位置,取值范围为 [0, this.size()]。
- subLen: UIntNative - 截取长度,取值范围为 [0, UIntNative.Max]。
返回值:
- CString - 截取的子串。
异常:
- IndexOutOfBoundsException - 如果 beginIndex 大于字符串长度,抛出异常。
- IllegalMemoryException - 如果内存申请失败或内存拷贝失败时,抛出异常。
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 数。
返回值:
示例:
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
功能:获取哈希值。
返回值:
- 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 数。
返回值:
示例:
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
功能:获取哈希值。
返回值:
- 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 数。
返回值:
示例:
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
功能:获取哈希值。
返回值:
- 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 - 往右数的个数。
返回值:
func position()
public func position(): Int64
功能:获取当前 Int16 值的位置信息,即将该 Int16 转换为 Int64 值。
返回值:
extend Int16 <: Hashable
extend Int16 <: Hashable
功能:为 Int16 类型扩展 Hashable 接口,支持计算哈希值。
父类型:
func hashCode()
public func hashCode(): Int64
功能:获取哈希值。
返回值:
- 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 - 往右数的个数。
返回值:
func position()
public func position(): Int64
功能:获取当前 Int32 值的位置信息,即将该 Int32 转换为 Int64 值。
返回值:
extend Int32 <: Hashable
extend Int32 <: Hashable
功能:为 Int32 类型扩展 Hashable 接口,支持计算哈希值。
父类型:
func hashCode()
public func hashCode(): Int64
功能:获取哈希值。
返回值:
- 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 - 往右数的个数。
返回值:
func position()
public func position(): Int64
功能:获取当前 Int64 值的位置信息,即返回该 Int64 值本身。
返回值:
extend Int64 <: Hashable
extend Int64 <: Hashable
功能:为 Int64 类型扩展 Hashable 接口,支持计算哈希值。
父类型:
func hashCode()
public func hashCode(): Int64
功能:获取哈希值。
返回值:
- 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 值的大小关系。
参数:
返回值:
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 - 往右数的个数。
返回值:
func position()
public func position(): Int64
功能:获取当前 Int8 值的位置信息,即将该 Int8 转换为 Int64 值。
返回值:
extend Int8 <: Hashable
extend Int8 <: Hashable
功能:为 Int8 类型扩展 Hashable 接口,支持计算哈希值。
父类型:
func hashCode()
public func hashCode(): Int64
功能:获取哈希值。
返回值:
- 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
功能:获取哈希值。
返回值:
- 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 编码规则转换成字符,并告知字符占用字节长度。
参数:
返回值:
static func getPreviousFromUtf8(Array<UInt8>, Int64)
public static func getPreviousFromUtf8(arr: Array<UInt8>, index: Int64): (Rune, Int64)
功能:获取字节数组中指定索引对应的字节所在的 UTF-8 编码字符,同时返回该字符首位字节码在数组中的索引。
当指定了一个索引,那么函数会找到数组对应索引位置并且根据 UTF-8 规则,查看该字节码是否是字符的首位字节码,如果不是就继续向前遍历,直到该字节码是首位字节码,然后利用字节码序列找到对应的字符。
参数:
返回值:
异常:
- IllegalArgumentException - 如果找不到对应首位字节码,即指定字节所在位置的字节不符合 UTF-8 编码,抛出异常。
static func intoUtf8Array(Rune, Array<UInt8>, Int64)
public static func intoUtf8Array(c: Rune, arr: Array<UInt8>, index: Int64): Int64
功能:该函数会把字符转成字节码序列然后覆盖 Array 数组内指定位置的字节码。
参数:
返回值:
- Int64 - 字符的字节码长度,例如中文是三个字节码长度。
static func utf8Size(Array<UInt8>, Int64)
public static func utf8Size(arr: Array<UInt8>, index: Int64): Int64
功能:该函数会返回字节数组指定索引位置为起始的字符占用的字节数。
在 UTF-8 编码中,ASCII 码首位字节第一位不为 1,其他长度的字符首位字节开头 1 的个数表明了该字符对应的字节码长度,该函数通过扫描首位,判断字节码长度。如果索引对应的不是首位字节码,就会抛出异常。
参数:
返回值:
- Int64 - 字符的字节码长度,例如中文是三个字节码长度。
异常:
- IllegalArgumentException - 如果索引位置的字节码不符合首位字节码规则,会抛出异常。
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 小写字符,如果无法转换则保持现状。
返回值:
func toAsciiUpperCase()
public func toAsciiUpperCase(): Rune
功能:将字符转换为 Ascii 大写字符,如果无法转换则保持现状。
返回值:
extend Rune <: Comparable<Rune>
extend Rune <: Comparable<Rune>
功能:为 Rune 类型扩展 Comparable<Rune> 接口,支持比较操作。
父类型:
func compare(Rune)
public func compare(rhs: Rune): Ordering
功能:判断当前 Rune 实例与指定 Rune 实例的大小关系。
Rune 的大小关系指的是它们对应的 unicode 码点的大小关系。
参数:
返回值:
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 - 往右数的个数。
返回值:
异常:
- OverflowException - 如果与 Int64 数进行加法运算后为不合法的 Unicode 值,抛出异常。
func position()
public func position(): Int64
功能:获取当前 Rune 值的位置信息,即将该 Rune 转换为 Int64 值。
返回值:
extend Rune <: Hashable
extend Rune <: Hashable
功能:为 Rune 类型扩展 Hashable 接口,支持计算哈希值。
父类型:
func hashCode()
public func hashCode(): Int64
功能:获取哈希值。
返回值:
- Int64 - 哈希值。
extend Rune <: ToString
extend Rune <: ToString
功能:这里为 Rune 类型扩展 ToString 接口,实现向 String 类型的转换。
父类型:
func toString()
public func toString(): String
功能:将 Rune 值转换为可输出的字符串。
返回值:
- String - 转化后的字符串。
UInt16
功能:表示 16 位无符号整型,表示范围为 [0, 2^{16} - 1]。
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
功能:获取哈希值。
返回值:
- Int64 - 哈希值。
extend UInt16 <: ToString
extend UInt16 <: ToString
功能:这里为 UInt16 类型扩展 ToString 接口,实现向 String 类型的转换。
父类型:
func toString()
public func toString(): String
功能:将 UInt16 值转换为可输出的字符串。
返回值:
- String - 转化后的字符串。
UInt32
功能:表示 32 位无符号整型,表示范围为 [0, 2^{32} - 1]。
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
功能:获取哈希值。
返回值:
- Int64 - 哈希值。
extend UInt32 <: ToString
extend UInt32 <: ToString
功能:这里为 UInt32 类型扩展 ToString 接口,实现向 String 类型的转换。
父类型:
func toString()
public func toString(): String
功能:将 UInt32 值转换为可输出的字符串。
返回值:
- String - 转化后的字符串。
UInt64
功能:表示 64 位无符号整型,表示范围为 [0, 2^{64} - 1]。
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
功能:获取哈希值。
返回值:
- Int64 - 哈希值。
extend UInt64 <: ToString
extend UInt64 <: ToString
功能:这里为 UInt64 类型扩展 ToString 接口,实现向 String 类型的转换。
父类型:
func toString()
public func toString(): String
功能:将 UInt64 值转换为可输出的字符串。
返回值:
- String - 转化后的字符串。
UInt8
功能:表示 8 位无符号整型,表示范围为 [0, 2^8 - 1]。
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 - 往右数的个数。
返回值:
func position()
public func position(): Int64
功能:获取当前 UInt8 值的位置信息,即将该 UInt8 转换为 Int64 值。
返回值:
extend UInt8 <: Hashable
extend UInt8 <: Hashable
功能:为 UInt8 类型扩展 Hashable 接口,支持计算哈希值。
父类型:
func hashCode()
public func hashCode(): Int64
功能:获取哈希值。
返回值:
- 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 值的大小关系。
参数:
- rhs: 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 - 往右数的个数。
返回值:
- UIntNative - 往右数
right
后所到位置的 UIntNative 值。
func position()
public func position(): Int64
功能:获取当前 UIntNative 值的位置信息,即将该 UIntNative 转换为 Int64 值。
返回值:
- Int64 - 当前 UIntNative 值的位置信息。
extend UIntNative <: Hashable
extend UIntNative <: Hashable
功能:为 UIntNative 类型扩展 Hashable 接口,支持计算哈希值。
父类型:
func hashCode()
public func hashCode(): Int64
功能:获取哈希值。
返回值:
- 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。
返回值:
- Int64 - 哈希值。
extend Unit <: ToString
extend Unit <: ToString
功能:为 Unit 类型其扩展 ToString 接口,实现向 String 类型的转换。
Unit 的字符串表示是 "()"。
父类型:
func toString()
public func toString(): String
功能:将 Unit 值转换为可输出的字符串。
返回值:
- String - 转化后的字符串。