Skip to main content
类型函数由 FunctionType 提供，用于值的显式转换与类型信息获取。

​
基础类型转换

这些转换函数会尽量按运行时的转换规则进行解析，当转换失败时通常返回 0 / 0L / 0f / 0d：
函数签名返回类型说明
intint(value)int尝试将值转换为整数。
longlong(value)long尝试将值转换为长整型。
floatfloat(value)float尝试将值转换为单精度浮点数。
doubledouble(value)double尝试将值转换为双精度浮点数。
stringstring(value)string按运行时规则转为字符串。
int("123")                # => 123
int("abc")                # => 0（转换失败）
double(1)                 # => 1.0
string(PI)                # => "3.141592653589793"

​
安全类型转换

安全转换函数在转换失败时返回 null 而不是默认值：
函数签名返回类型说明
intOrNullintOrNull(value)int?尝试转换为整数，失败返回 null。
longOrNulllongOrNull(value)long?尝试转换为长整型，失败返回 null。
floatOrNullfloatOrNull(value)float?尝试转换为单精度浮点数，失败返回 null。
doubleOrNulldoubleOrNull(value)double?尝试转换为双精度浮点数，失败返回 null。
intOrNull("123")          # => 123
intOrNull("abc")          # => null

# 配合 Elvis 运算符使用
value = intOrNull(&input) ?: -1

​
类型检查

函数签名返回类型说明
isStringisString(value)boolean检查值是否为字符串类型。
isNumberisNumber(value)boolean检查值是否为数值类型（int/long/float/double）。
isArrayisArray(value)boolean检查值是否为数组类型。
isListisList(value)boolean检查值是否为列表类型。
isMapisMap(value)boolean检查值是否为映射类型。
typeOftypeOf(value)string返回底层对象的简短类型名。若为 null，返回字符串 "null"。
isString("hello")         # => true
isString(123)             # => false
isNumber(3.14)            # => true
isList([1, 2, 3])         # => true
isMap([a: 1, b: 2])       # => true

typeOf("hello")           # => "String"
typeOf(123)               # => "Integer"
typeOf(null)              # => "null"
类型检查也可以使用 is 运算符：&value is string 等价于 isString(&value)。详见 运算符与优先级。

​
集合转换

函数签名返回类型说明
arrayarray(collection)Array 或 null若参数是 Collection，则转为数组并返回；否则返回 null。
listlist(array)List将数组转换为不可变列表。
mutableListmutableList(array)MutableList将数组转换为可变列表。
# 列表转数组
items = [1, 2, 3]
arr = array(&items)

# 数组转列表
newList = list(&arr)
mutableItems = mutableList(&arr)
mutableItems :: add(4)    # 可变列表可以添加元素

​
相关链接