插件详情

名称：longys

导入：compile("longys:1.1.4")

作者：余生

简介：常用函数工具插件

# Lua常用工具函数

本文介绍了一些常用的Lua工具函数，可以提高Lua编程的效率。

## 函数列表

以下是本文介绍的函数列表：
- `split(str, delimiter)` 函数：使用指定的分隔符拆分字符串为数组。
- `sleep(ms1,ms2)` 函数：根据传入的参数生成睡眠时间。
- `printTable(t, indent)` 函数：以易于阅读的方式打印出一个表格。
- `deepCopy(original)` 函数：深度复制一个表格。
- `isNumeric(n)` 函数：判断一个变量是否为数字类型。
- `isEmpty(sty)` 函数：判断一个字符串是否为空。
- `tableSize(t)` 函数：返回一个表格中元素的数量。
- `tableConcat(t1, t2)` 函数：将两个表格合并为一个新表格。
- `shuffleTable(t)` 函数：随机打乱一个表格的顺序。
- `round(number, decimals)` 函数：四舍五入一个数字到指定的小数位数。
- `tableHasKey(t, key)` 函数：判断一个表格是否包含指定的键。
- `tableContains(t, value)` 函数：判断一个表格中是否包含指定的值。
- `tableIndexOf(t, value)` 函数：返回一个表格中指定值的索引。
- `stringStartsWith(str, prefix)` 函数：判断一个字符串是否以指定的前缀开头。
- `stringEndsWith(str, suffix)` 函数：判断一个字符串是否以指定的后缀结尾。
- `stringTrim(str)` 函数：去掉一个字符串两端的空白字符。

## 函数详细介绍
##### 所有函数调用前面都加【ys.】 例如：ys.split()

### `split(str, delimiter)` 函数

使用指定的分隔符拆分字符串为数组。

#### 参数

- `str` (string)：要拆分的字符串。
- `delimiter` (string)：分隔符字符串。

#### 返回值

- `table`：拆分后的数组。

#### 使用案例

```lua
local str = "abc|def|hij"
local myTable = ys.split(str,"|"); --返回数组：{"abc", "def", "hij"}
```

## 动作函数
### `find(rule,ms):run()` 查找节点
查找出一个节点结果。
### `find(rule,ms):click():run()` 查找节点并点击
查找一个节点并执行点击操作。

#### 参数

- `rule` (R())：检索规则。
- `ms` (number)：查找超时时间，默认1000毫秒（可选）。

#### 使用案例

```lua
--查找出一个节点结果
local view = ys:find(t.任务中心):run();
if view then
	print(view.rect.left..','..view.rect.top..','..view.rect.right..','..view.rect.bottom);
end

--查找一个节点并执行点击操作，会返回节点结果
local view = ys:find(t.任务中心):click():run();

--查找一个节点并点击指定坐标
ys:find(t.任务中心):click(500,500):run();

--click()也可以单独使用
ys:click(500,500);
```