# 前言
定位
basicFunction 的定位非常清晰，那就是作为脚本制作者的配置扩展，通过在lua脚本中 require "basicFunction"使用其中的函数。
下载
由于下文可能会太长因此将下载链接开门见山的放在这里：
原帖
basicFunction-alpha(2).zip
最后
衷心希望大家指正其中的错误和不足，促使 basicFunction 不断进步完善
__________________________________________________________________________.
如何使用？
搭载
——开始之前的一些必要工作。
1.下载 basicFunction并解压得到 basicFunction.lua文件
2.将解压得到的 basicFunction.lua文件放入 DiceQQ\plugin\文件夹
3.在确保前两步万无一失的情况下回到聊天窗口使用 .system load命令重载 basicFunction脚本
看到这里，你已经成功安装完成了！接下来让我们快速开始吧！
# 在聊天窗口使用
为了方便测试函数，简律纯特别的写了一个聊天窗口指令，用于测试这些函数
[xxx]. #basicFunction:help
这是一条用于获取帮助与更新的指令，不建议在群聊中使用。
[1] #basicFunction:table_draw
- 功能：随机抽取一条数组内元素
- 参数：数组
- 返回：字符串
- 示例：
[2] #basicFunction:num_or_string
- 功能：判断是否为num类型，若是则自动转为num类型，否则为string
- 参数：x:待转换字符串
- 返回：number类型数据或string类型数据
- 示例：
[3] #basicFunction:getAtQQ
- 功能：取at对象的qq
- 参数：字符串（尤指CQ码）
- 返回：文本形式的qq号
-示例：
[4] #basicFunction:write_file
- 功能：追加写文件，没有则创建
- 参数：文件路径，文件内容
- 返回：提示文本
- 说明：文件根目录DiceQQ//，我在生成文件时写了点注释，就比如会在当文件读写时在第一行特别注明文件名。
- 示例：
[5] #basicFunction:read_file
- 功能：读取文件全部内容
- 参数：文件路径
- 返回：有内容则返回字符串否则返回错误提示
- 示例：
[6] #basicFunction:filter_spec_chars
- 功能：捕获并提取所有中文，合并后输出
- 参数：待捕获中文的字符串
- 返回：所有中文合并后的字符串
-示例：
[7] #basicFunction:getFileName
- 功能：取文件名，有扩展名
- 参数：文件路径
- 返回：字符串
-示例：
[8] #basicFunction:getFileName2
- 功能：取文件名，无扩展名
- 参数：文件路径
- 返回：字符串
- 示例：
[9] #basicFunction:utfStrLen
- 功能：返回文本中的字符总数目
- 参数：字符串
- 返回：数字
- 示例：
[11] #basicFunction:table_exists
- 功能：判断数组中是否存在指定字符串
- 参数：数组，查找的字符串
- 返回：有则为true，没有则什么都不返回
- 示例：
先看一下内部代码，设定了一个tables
接着输入看看效果
[13] #basicFunction:string.split
- 功能：分割字符串
- 参数：待分割字符串，分隔符
- 返回：字符串表
- 示例：
[14] #basicFunction:string.count
- 功能：统计字符串中字符的个数
- 参数：待统计的字符串
- 返回：总字符个数、英文字符数、中文字符数
- 示例：
[15] #basicFunction:string.width
- 功能：计算字符串的宽度
- 参数：字符串
- 返回：数字
- 说明：这里一个中文等于两个英文，后面的情况同理，此函数和 utfStrLen原理类似
- 示例：
[16] #basicFunction:string.tocenter
- 功能: 把字符串扩展为长度为len,居中对齐, 其他地方以filledChar补齐
- 参数: 需要被扩展的字符、数字、字符串表，被扩展成的长度，填充字符（可以为空）
- 返回：字符串
- 示例：
[3+14] #basicFunction:string.toleft
- 功能: 把字符串扩展为长度为len,左对齐, 其他地方用filledChar补齐
- 参数：需要被扩展的字符、数字、字符串表，被扩展成的长度，填充字符（可以为空）
- 返回：字符串
- 说明：中文相当于2个英文
- 示例：
[18] #basicFunction:string.toright
- 功能: 把字符串扩展为长度为len,右对齐, 其他地方用filledChar补齐
- 参数：需要被扩展的字符、数字、字符串表，被扩展成的长度，填充字符（可以为空）
- 返回：字符串
- 示例：
[19] #basicFunction:string.ltrim
- 功能：对齐，去除通配符
- 参数：文本
- 返回：文本
- 示例：暂无
[20] #basicFunction:string.rtrim
- 功能：对齐，去除通配符
- 参数：文本
- 返回：文本
- 示例：暂无
[21] #basicFunction:string.trim
- 功能：对齐，去除通配符
- 参数：文本
- 返回：文本
- 示例：暂无
[22] #basicFunction:ranStr
- 功能：随机输出字符串
- 参数：数字（输出个数）
- 返回：字符串
- 示例：
错误的错误就是没有错误（好耶！我又说了一句凡人名言）
那么，换成别的函数还会如此吗？
这里以 bubbleSort 函数为例因为很快就要讲到ta了
很好，果然不负众望的报错并让krypton拦截了
那么输入参数会发生什么？
…to be continue
[24] #basicFunction:bubbleSort
- 功能：冒泡（升序）排序
- 参数：tab:目标表
- 返回：排好序的文本
- 示例：
tab = {3, 4, 61, 7, 5, 8, 56, 14, 11, 10}
return bubbleSort(tab)
[25] #basicFunction:load
- 功能：安全执行lua语句
- 说明：暂时弃用
- 示例：暂无
[26] #basicFunction:sortTable_delRepeat
- 功能：将重复出现的数字全部删除(后续数字往前移)
- 参数：tab:数组
- 返回：去完重的字符串（多半还是降序的）
- 示例：
[27-1] #basicFunction:Round
- 功能：四舍五入(常用)
- 参数：num:待计算数字
- 返回：计算结果
- 示例：
[27-2] #basicFunction:Round2
- 功能：四舍五入(奇进偶舍)
- 参数：num:待计算数字 i:保留几位小数
- 返回：计算结果
- 示例：
[28] #basicFunction:Multiply
- 功能：相乘，同时判断了是否有null值
- 参数：都看得懂吧//两个数字…
- 返回：计算结果
- 示例：
[29] #basicFunction:Divide
- 功能：相除
- 参数：denominator:除数 numerator:被除数
- 返回：计算结果
- 示例：
[30-1] #basicFunction:Ceil
- 功能：取整
- 参数：数字
- 返回：结果
- 示例：
[30-2] #basicFunction:Ceil2
- 参数：数字
- 返回：结果
- 说明：第二种取整思路
- 示例：
[31] #basicFunction:unicode2Chinese
- 功能：利用JSON解析器把Unicode转中文汉字
- 参数：uni:完整的json格式Unicode码
- 返回：汉字字符串
- 示例：
[32] #basicFunction:stamp2Time
- 功能：时间戳转时间
- 参数：Stamp:时间戳
- 返回：字符串
-示例：
[33] #basicFunction:Match
- 功能：匹配截取字符串
- 参数：msg:待匹配的字符串 num:截取位置
- 说明：汉字长度为2，特别注意
- 示例：
[34-1] #basicFunction:fitemSort
- 功能：取数据存入数组
- 参数：字符串
- 返回：数组
- 示例：暂无
[34-2] #basicFunction:ffitemSort
- 功能：取数据存入数组
- 参数：字符串
- 返回：数组
- 示例：暂无
FUNCTION INDEX&LIST:
[1]table_draw(tab) LINE:48
[2]num_or_string(x) LINE:55
[3]getAtQQ(str) LINE:67
[4]write_file(path, text) LINE:79
[5]read_file(path) LINE:88
[6]filter_spec_chars(s) LINE:103
[7]getFileName(path) LINE:133
[8]getFileName2(path) LINE:140
[9]utfstrlen(str) LINE:147
[10]MD5(str) LINE:168
[11]table_exists(tables,value) LINE:395
[12]encodeBase64(source_str) LINE:408
[13]string.split(str, delimiter) LINE:443
[14]string.count(str) LINE:460
[15]string.width(str) LINE:470
[16]string.tocenter(str, len, filledChar) LINE:479
[17]string.toleft(str, len, filledChar) LINE:511
[18]string.toright(str, len, filledChar) LINE:540
[19]string.ltrim(str) LINE:573
[20]string.rtrim(str) LINE:577
[21]string.trim(str) LINE:581
[22]ranStr(num) LINE:588
[23]tryCatch(fun) LINE:604
[24]bubbleSort(tab) LINE:620
[25]弃用 LINE:646
[26]sortTable_delRepeat(tab) LINE:653
[27-1]Round(num, i) LINE:672
[27-2]Round2(num, i) LINE:681
[28]Multiply(num1,num2) LINE:702
[29]Divide(denominator,numerator) LINE:718
[30-1]Ceil(num) LINE:734
[30-2]Ceil2(num) LINE:753
[31]unicode2Chinese(uni) LINE:765
[32]stamp2Time(Stamp) LINE:782
[33]Match(msg,num) LINE:789
[34-1]fitemSort(rest) LINE:798
[34-2]ffitemSort(rest) LINE:809
# 在lua编写过程中使用
由于时间来不及，在lua中使用的教程与进阶用法将会在日后补齐。
to be…
# 一些实例
getAtQQ的使用：【指令脚本】爬/丢/赞
tryCatch的使用：【指令脚本/思想】巴拉巴拉骰娘自检和偷懒自定义报错什么的
