本文为您介绍数组类型相关函数的语法、参数、示例和返回值。

arr_concat

使用arr_concat将字段表中的字符串按照指定的字符进行连接，函数的详细信息见下表。
项目 描述
语法 arr_concat(tbl, sep)
参数
  • tbl：数组变量。
  • sep（可选参数）：拼接符，默认为空串拼接。
示例 
d = ['t1','t2','t3']
say(arr_concat(d, '&'))
返回值 返回拼接后的字符串，返回值为字符类型。本示例的返回值为t1&t2&t3。

arr_insert

使用arr_insert向数组中插入值，函数的详细信息见下表。
项目 描述
语法 arr_insert(list, value, [pos])
参数
  • list：数组类型。
  • value：任意类型。
  • pos：number类型，不能为0。list索引默认从1开始，在list的pos处插入元素value，并将元素pos+1后移至尾部元素；如果未指定pos，默认从末尾插入。
示例 
tbl_1 = []
arr_insert(tbl_1, '1')
arr_insert(tbl_1, '3')
arr_insert(tbl_1, '5')
arr_insert(tbl_1, '2')
arr_insert(tbl_1, '6', 1)
str = arr_concat(tbl_1, '')
say(concat('arr_insert:', str))
返回值 始终返回true。本示例的返回值为arr_insert:61352。

arr_remove

使用arr_remove移除list中指定位置的元素并返回被移除元素的值，无pos时返回尾部位置的元素对应的值，函数的详细信息见下表。
项目 描述
语法 arr_remove(list, [pos])
参数
  • list：数组类型。
  • pos：number类型。
示例 
tbl_1 = []
arr_insert(tbl_1, '1')
arr_insert(tbl_1, '3')
arr_insert(tbl_1, '5')
arr_insert(tbl_1, '2')
say(concat('arr_remove:', arr_remove(tbl_1, 2)))
返回值 返回值为被移除位置的数据。本示例的返回值为arr_remove:3。

arr_sort

使用arr_sort对list元素从索引的头部到索引的尾部按指定次序排序。
  • 如果提供了comp，comp必须是一个可以接收两个列表内元素为参数的函数。当第一个元素需要排在第二个元素之前时，返回true。
  • 如果未提供comp，则按字符的ANSII码从小到大排序。这种排序算法不稳定，即当两个元素次序相等时，这两个元素在排序后的相对位置可能会改变。
函数的详细信息见下表。
项目 描述
语法 arr_sort(list, [comp])
参数
  • list：数组类型。
  • comp：自定义排序算法函数，该参数的类型为函数。
示例 
tbl_1 = []
arr_insert(tbl_1, '1')
arr_insert(tbl_1, '3')
arr_insert(tbl_1, '5')
arr_insert(tbl_1, '2')
say(concat('remove:', arr_remove(tbl_1, 2)))
str = arr_concat(tbl_1, '')
say(concat('insert:', str))
arr_sort(tbl_1)
str = arr_concat(tbl_1, '')
say(concat('sort:', str))
def my_comp(a, b){
  a = tonumber(a)
  b = tonumber(b)
  if gt(a, b) {
    return true
  }
  return false
}
arr_sort(tbl_1, my_comp)
str = arr_concat(tbl_1, '')
say(concat('sort_comp:', str))
返回值 始终返回true。本示例的返回值如下：
remove:3
insert:152
sort:125
sort_comp:521

arr_len

使用arr_len计算数组的元素个数，函数的详细信息见下表。
项目 描述
语法 arr_len(arr)
参数 arr：数组变量。
示例 
d = []
set(d, 1, 'v1')
say(arr_len(d))
返回值 返回值为数字类型，本示例的返回值为1。