文本与数组

本页收录 TextBuiltins 和 ArrayBuiltins，适合做文本整理、格式化、列表构造与集合处理。

文本长度

• 用法：文本长度(文本)
• 参数：1 个文本
• 返回值：Number

赋值 len = 文本长度(player.name)
发送消息("&f名称长度: " + len)

截取文本

• 用法：截取文本(文本, 开始, 结束)
• 参数：文本、开始下标、结束下标
• 返回值：String

赋值 prefix = 截取文本(player.name, 0, 3)
发送消息("&7前缀片段: " + prefix)

转大写

• 用法：转大写(文本)
• 参数：1 个文本
• 返回值：String

赋值 key = 转大写("daily_sign")
发送消息("&f键名: " + key)

转小写

• 用法：转小写(文本)
• 参数：1 个文本
• 返回值：String

赋值 worldId = 转小写(获取世界名())
发送消息("&7世界标识: " + worldId)

去空格

• 用法：去空格(文本)
• 参数：1 个文本
• 返回值：String

赋值 clean = 去空格("  VIP 玩家  ")
发送消息("&f结果: " + clean)

文本开头是

• 用法：文本开头是(文本, 前缀)
• 参数：文本、前缀
• 返回值：Boolean

判断 (文本开头是(player.name, "VIP_")) {
  发送消息("&6检测到 VIP 前缀")
}

文本结尾是

• 用法：文本结尾是(文本, 后缀)
• 参数：文本、后缀
• 返回值：Boolean

判断 (文本结尾是(获取世界名(), "_nether")) {
  发送消息("&c当前位于下界世界")
}

文本包含

• 用法：文本包含(文本, 子串)
• 参数：文本、子串
• 返回值：Boolean

判断 (文本包含(event.message, "签到")) {
  增加成就进度(1)
}

文本替换

• 用法：文本替换(文本, 查找, 替换)
• 参数：文本、查找内容、替换内容
• 返回值：String

赋值 msg = 文本替换("&aHello_{player}", "{player}", player.name)
发送消息(msg)

文本分割

• 用法：文本分割(文本, 分隔符)
• 参数：文本、分隔符
• 返回值：List

赋值 parts = 文本分割("每日,周常,赛季", ",")
赋值 first = 取数组元素(parts, 0)

文本拼接

• 用法：文本拼接(文本...)
• 参数：1 个或更多文本
• 返回值：String

赋值 title = 文本拼接("&6", player.name, " 的成就面板")
发送消息(title)

查找位置

• 用法：查找位置(文本, 子串)
• 参数：文本、子串
• 返回值：Number

赋值 pos = 查找位置("daily_sign_reward", "_")
发送消息("&7下划线位置: " + pos)

转文本

• 用法：转文本(值)
• 参数：任意值
• 返回值：String

赋值 text = 转文本(获取进度())
发送消息("&f当前进度文本: " + text)

格式化文本

• 用法：格式化文本(模板, 参数...)
• 参数：模板、占位参数
• 返回值：String

赋值 msg = 格式化文本("玩家 {0} 完成了 {1}", player.name, 获取成就名称())
发送消息(msg)

重复文本

• 用法：重复文本(文本, 次数)
• 参数：文本、次数
• 返回值：String

赋值 line = 重复文本("=", 10)
发送消息("&7" + line)

是否为空

• 用法：是否为空(文本)
• 参数：1 个文本
• 返回值：Boolean

判断 (是否为空(获取手持物品名称())) {
  发送消息("&7当前物品没有显示名")
}

是否不为空

• 用法：是否不为空(文本)
• 参数：1 个文本
• 返回值：Boolean

判断 (是否不为空(取全局变量("活动阶段"))) {
  发送消息("&a活动阶段已配置")
}

文本统计

• 用法：文本统计(文本, 字符)
• 参数：文本、字符或子串
• 返回值：Number

赋值 count = 文本统计("a,b,c,d", ",")
发送消息("&f分隔符数量: " + count)

随机文本

• 用法：随机文本(文本...)
• 参数：1 个或更多文本
• 返回值：String

赋值 line = 随机文本("&a做得好", "&b继续加油", "&d今天运气不错")
发送消息(line)

创建数组

• 用法：创建数组(元素...)
• 参数：1 个或更多元素
• 返回值：List

赋值 rewards = 创建数组("金币", "经验", "称号")

取数组元素

• 用法：取数组元素(数组, 索引)
• 参数：数组、索引
• 返回值：Object

赋值 rewards = 创建数组("金币", "经验", "称号")
赋值 first = 取数组元素(rewards, 0)

数组长度

• 用法：数组长度(数组)
• 参数：1 个数组
• 返回值：Number

赋值 rewards = 创建数组("金币", "经验", "称号")
发送消息("&f数量: " + 数组长度(rewards))

数组追加

• 用法：数组追加(数组, 元素)
• 参数：数组、元素
• 返回值：List

赋值 rewards = 创建数组("金币", "经验")
赋值 rewards = 数组追加(rewards, "钥匙")

数组包含

• 用法：数组包含(数组, 元素)
• 参数：数组、元素
• 返回值：Boolean

赋值 rewards = 创建数组("金币", "经验", "钥匙")
判断 (数组包含(rewards, "钥匙")) {
  发送消息("&a奖励池包含钥匙")
}

数组连接

• 用法：数组连接(数组, 分隔符)
• 参数：数组、分隔符
• 返回值：String

赋值 rewards = 创建数组("金币", "经验", "钥匙")
赋值 text = 数组连接(rewards, " / ")

数组移除

• 用法：数组移除(数组, 索引)
• 参数：数组、索引
• 返回值：List

赋值 rewards = 创建数组("金币", "经验", "钥匙")
赋值 rewards = 数组移除(rewards, 1)

数组设置

• 用法：数组设置(数组, 索引, 值)
• 参数：数组、索引、新值
• 返回值：List

赋值 rewards = 创建数组("金币", "经验", "钥匙")
赋值 rewards = 数组设置(rewards, 1, "点券")

数组切片

• 用法：数组切片(数组, 开始, 结束)
• 参数：数组、开始索引、结束索引
• 返回值：List

赋值 rewards = 创建数组("金币", "经验", "钥匙", "称号")
赋值 part = 数组切片(rewards, 1, 3)

数组反转

• 用法：数组反转(数组)
• 参数：1 个数组
• 返回值：List

赋值 rewards = 创建数组("一", "二", "三")
赋值 reversed = 数组反转(rewards)

数组排序

• 用法：数组排序(数组)
• 参数：1 个数组
• 返回值：List

赋值 scores = 创建数组(30, 10, 20)
赋值 sorted = 数组排序(scores)

查找元素索引

• 用法：查找元素索引(数组, 元素)
• 参数：数组、元素
• 返回值：Number

赋值 rewards = 创建数组("金币", "经验", "钥匙")
赋值 idx = 查找元素索引(rewards, "钥匙")

数组去重

• 用法：数组去重(数组)
• 参数：1 个数组
• 返回值：List

赋值 tags = 创建数组("签到", "签到", "周常")
赋值 unique = 数组去重(tags)

数组筛选非空

• 用法：数组筛选非空(数组)
• 参数：1 个数组
• 返回值：List

赋值 raw = 创建数组("签到", "", null, "周常")
赋值 clean = 数组筛选非空(raw)

是否为空数组

• 用法：是否为空数组(数组)
• 参数：1 个数组
• 返回值：Boolean

赋值 list = 创建数组()
判断 (是否为空数组(list)) {
  发送消息("&7当前列表为空")
}