青语言使用文档

集合函数

创建于 2023-04-23 / 最近更新于 2023-04-25 / 2109
字体: [默认] [大] [更大]

@取长度

参数1-字符串|数组|对象|二进制,返回整数;获取第一个参数的长度
示例:

@取长度、“123”
@取长度、【1, 2, 3】
@取长度、{}

@追加

参数1-字符串|数组,参数2-任意,可选参数3-逻辑,返回参数1;对于字符串会在末尾追加参数2转换为字符串的值,对于数组会把参数2追加到数组末尾。注意,如果参数1和参数2都是数组,那么会把参数2中的每一个值追加到参数1数组的末尾,如果需要把数组作为一个值进行追加,需要再传入一个逻辑真
示例:

@追加【“123”, “45”】      ;返回 “12345”
@追加【【1, 2, 3】, 【4, 5】】 ;返回 【1, 2, 3, 4, 5】
@追加【【1, 2, 3】, 【4, 5】,真】 ;返回 【1, 2, 3,【 4, 5】】

@插入

参数1-数组|字符串|二进制,参数2-整数,参数3-任意,返回参数1;参数1为集合,根据参数2指定的位置,将参数3插入到参数1中
示例:

@插入【“123”,1,“45”】    ;返回  “14523”
@插入【【1, 2, 3】, 1, 4】      ;返回【1, 4, 2, 3】

@取出

参数1-字符串|数组|二进制,参数2-整数,返回任意;参数1为集合,从参数2指定的位置中取出1个元素
示例:

@取出【“123”,1】    ;返回  “2”, 参数1字符串变为 “13”
@取出【【1, 2, 3】, 1】      ;返回 2,参数1数组变为 【1, 3】

@取出

参数1-字符串|数组|二进制,参数2-整数,可选参数3-整数,返回任意;参数1为集合,从参数2指定的位置中取出1个元素,如果传入参数3,那么取出参数3指定个数的元素
示例:

@取出【“123”,1】    ;返回  “2”, 参数1字符串变为 “13”
@取出【【1, 2, 3】, 1,2】      ;返回 【2, 3】,参数1数组变为 【1】

注意,@取出会修改集合的值


@切片

参数1-字符串|数组|二进制,参数2-整数,可选参数3-整数,返回字符串|数组|二进制;参数1为集合,以参数2为起始位置,参数3为终止位置(默认为结尾),截取集合片段
示例:

@切片【“123”,2】    ;返回  “23”
@切片【【1, 2, 3】, 1,2】      ;返回 【2, 3】

切片和取出类似,但@取出会修改集合的值,而@切片不会


@替换

参数1-字符串|数组,参数2-任意,参数3-任意,可选参数4-整数,返回参数1;参数1为集合,参数2为替换的旧值,参数3为替换的新值,参数4为替换的次数,默认全部替换
示例:

@替换【“1234”,“23”, “0”】    ;返回  “104”
@替换【【1, 2, 3】, 【2, 3】, 5】      ;返回 【1, 5】
@替换【“1111”,“1”, “0”, 2】    ;这里指定了最多替换2次,返回  “0011”

@查找

参数1-字符串|数组,参数2-任意,可选参数3-整数,返回整数;从参数1中查找参数2的值,返回查找到的位置,如果传入参数3,则作为查找的起始位置
示例:

@查找【“1234”,“23”】    ;返回  1
@查找【【1, 2, 3】,“23”】    ;不存在,返回  -1
@查找【“1234”,“23”,2】    ;从序号为2的位置开始查找,找不到,返回  -1

@分割

参数1-字符串|数组,参数2-任意,返回数组;根据参数2,将参数1分割为多个片段
示例:

@分割【“1234”,“23”】    ;返回  【“1”,“4”】
@分割【【1, 2, 3, 4】,【2, 3】】    ;返回  【【1】,【4】】

@裁切

参数1-字符串|数组,可选参数2-整数,可选参数3-任意,返回参数1;参数1为集合,默认全裁切,参数2为0时做全裁切,参数2小于0时做左裁切,参数2大于0时做右裁切,参数3指定裁切的目标,默认为空值或空白字符
示例:

@裁切、“   123    ”   ;返回  “123”
@裁切【“   123    ” , 1】    ;返回  “   123”
@裁切【“1234444” , 1,“4”】    ;返回  “123”

1 人点赞过