fun-tools

一、基本函数
直接调用的函数。常用的一些函数封装。

在载入这个库包后，直接使用fun.*来调用函数。

1.1 ipToInt(sIP)
fun.ipToInt(sIP)

将一个IP字串，转成一个整形数字。

1.1.1 sIP
字符串

如"192.168.0.1"这样之类的IP字符串。

1.1.2 返回值
数字

IP的整形数字

1.2 intToIp(nIP)
fun.intToIp(nIP)

将一个整数，转成IP字符串。

1.2.1 nIP
数字

IP的整数

1.2.2 返回值
字符串

显示的IP字串

1.3 format(sStr, args)
fun.format(sStr, args)

类似C的字符串格式工具

1.3.1 sStr
字符串

被替换的字串

{0}表示args数组里的[0]

{1}表示args数组里的[1]

1.3.2 args
数组

替换到sStr里面去

1.3.3 返回值
替换后的字符串

1.4 dateStr(dDate, bZzz)
fun.dateStr(dDate, bZzz)

将一个日期形变量，转成日期字符串

1.4.1 dDate
日期

要转换日期变量

1.4.2 bZzz
Boolean

是否显示毫秒，默是false

1.4.3 返回值
字符串

"2016-08-30 19:33:34"

或

"2016-08-30 19:33:34.342"

1.5 strDate(str)
fun.strDate(str)

将一个字串，转成日期

1.5.1 str
String

标准的日期字串，"yyyy-mm-dd hh:nn:ss"

1.5.2 返回值
Date

日期对象

1.6 num(param, bNegative)
fun.num(param, bNegative)

将一个对象，转成数字

1.6.1 param
任何变量

null, undefined, "", 都会转为0

1.6.2 bNegative
Boolean

默认为false

当为true时，将会保留负数。

为false时，将保存为正数。

1.7 numChs(num)
将一个数字，转成中文的汉字

1.8 chkPhoneNum(sTel)
fun.chkPhoneNum(sTel)

判断一个字串，是否为正常的电话

1.8.1 sTel
String

电话字串

1.8.2 返回值
Boolean

正常电话返回True

其他为False

1.9 money(val)
fun.money(val)

将一个数字，转成金额。小数点保留两位的数字。

1.9.1 val
Number

要转成金额的数字

1.10 formatDatetime(sDTFormat, dDT)
fun.formatDatetime(sDTFormat, dDT)

将一个日期，格式化成任意样式

1.10.1 sDTFormat
String

格式字串，

yyyy 年

m 月

mm 双位月

d 日

dd 双位日

h 时

hh 双位时

n 分

nn 双位分

s 秒

ss 双位秒

zzz 毫秒

1.10.2 dDT
Date

要处理的日期

1.10.3 返回值
String

转换后的字符串

1.11 putString(nNum, sStr)
将一个字串，循环几次拼起来

如：

putString(5, "yes!");

返回：

"yes!yes!yes!yes!yes!"

1.11.1 nNum
number

要循环几次，必须为数字，否则返回空字串。

1.11.2 sStr
string

要循环的字串，默认为“ ”（空格）

1.12 clone(oSrc, bSort)
将oSrc，深复制到新的对象上。并返回这个对象

bSort： 是否要将key排序

1.13 seekVal(jOpts)
从一个JSON of Array中，找到自己想要的节点。

可以是树型的树结构。

var aOneR = fun.seekVal({

data: aRights,

key: "userid",

val: jRe.list[i].id

});

1.13.1 jOpts
JSON

JSON的形式的参数传递

1.13.1.1 data
Array

要被查找的数组，JSON of Array

1.13.1.2 key
string

查找，结构中的key

1.13.1.3 val
string

结构中的val内容，如果key与val都一样匹配上的话，则找到这个对象。会直接返回这个对象。

1.13.1.4 callback(jD, subkey, arrlist)
function

用户自己的回调函数。如果返回内容，则认为是找到了对象。

一旦设置了callback，key与val将失去意义。

jD: 当前找到的数据对象

subkey: 当前是从哪个subkey找到的

arrlist: 父层的数组总数。

1.13.1.5 subkey
string / array

如果是树形，则还可以递归去查找它的子层。subkey，则是指定，哪个对象，是它可以向下子层

2017-07-26

增加可以有，多个子层的方式。subkey，可以是数组，也可以是字串用“,”隔开的多个关键字。

1.13.1.6 downto
boolean

在对subkey的数组处理时，使用从length到0的方式，倒向处理。

1.14 enumVal(jOpts)
枚举出所有的JSON对象，使用callback回调执行

1.14.1 jOpts

1.14.1.1 data
JSON / Array

一个对象或者是数组

1.14.1.2 callback(thedata, thekey, pdata, pkey)

1.15 getTree(jOpts)
将一个数组列表，转成一个树型

1.15.1 jOpts

1.15.1.1 list | data
array of JSON

数组

1.15.1.2 idkey
string

ID列的字段名称

1.15.1.3 pidkey
string

标记自己父层的字段名称

1.15.1.4 containkey
string

包含子集的字段名称，自己定义

1.15.1.5 callback(list)
回调当前层的列表

如果回调有返回值，则会用这个返回值，去覆盖当前层数组。

1.15.1.6 indexkey
是否使用某个字段，进行排序。

1.15.1.7 indexordery

1.16 toArray(strlist, jOpts)
将一个字符串，转换成数组

数组成员，不会重复的数组成员，

1.16.1 strlist
string

要转换的字符串

例如

"134,1234,532"

1.16.2 jOpts
JSON

更多的配置信息

1.16.2.1 type
string

最终数组的类型

有string, number等等

1.16.2.2 split
string

字符串当中的分隔符

1.17 arr(any, jOpts)
将一个变量，转成数组。

1.17.1 any
任间变量，可以是字符串，也可以是数组，也可以是其他

1.17.2 jOpts
JSON

设置信息

1.17.2.1 split
如果是输入的是字符串，那将它分拆成多个时，它们之间的分隔符是什么

1.17.2.2 type
数组里，期待的变量类型。

num，无符号数字。fun.num处理
number，数字

string，字符串

等等

1.17.2.3 distinct
boolean

true: 返回数组不能重复

1.18 orderBy(jOpts)
对一个复杂对象数据，进行排序

返回排序后的对象数组

1.18.1 jOpts
JSON对象

1.18.1.1 data
数组，要处理的数据

1.18.1.2 key
用来排序的字段

1.18.1.3 order
排序方式

asc 正序

desc 倒序

1.19 randomFrom(lower, upper)
获得一个范围的随机数。

1.20 replaceJSON(txt, JSON)
将一段文本，用JSON的属性替换。

txt：文本原文，里面的{{xxx}}，将被JSON里的属性替换

JSON：JSON对象

txt: "my name is {{name}}."

JSON: {name: "bzm"}

返回的是："my name is bzm."

1.21 animate(nFrom, nTo, callback)
动画函数，给一个开始，到结束的值。然后再通过回调出来

1.22 keyValue(src, split1, split2)
得到某字符串中，key=val的键值对

1.23 functionName(arguments_callee_toString)
通过函数整个内容的字符，得到函数的名称。

1.24 parseUrl(url)
把一个URL，转换成对象形式的样子。

1.24.1 url
strubg

URL的字符串。如：

http://127.0.0.1/iss.html?key=34&rer=42#kkk343421

1.24.2 返回

1.24.2.1 hash
kkk343421

1.24.2.2 host
127.0.0.1

1.24.2.3 path
/iss.html

1.24.2.4 protocol
http

1.24.2.5 query

1.24.2.5.1 key
34

1.24.2.5.2 rer
42

1.25 localPos(pos[], arr[[]])
传入一个坐标pos，和一组坐标数组arr。

返回在arr里最接近pos的坐标位置的index

1.25.1 pos[]
array of number

1.25.2 arr[[]]

1.25.3 返回
number

pos在arr的位置

1.26 fileSize(num, type)
将一串数字，格式成文件大小

type:

kb,mb,gb,tb等

1.27 valueConvert(val, type)
获得一个数据，在数据库表示的样子

1.27.1 val

1.27.2 type
string

date:

string:

number:

1.28 flyTime(t)
友好的时间显示

15秒前

6分钟前

3小时前

昨天 19:32

12-23 19:40

2021-01-21 17:54

1.29 logSetup(cs, mute)
将系统的console.log函数，替换成自己的。

在使用log函数时，在前面会插入系统时间。

1.29.1 cs
console

必须传入console对象

1.29.2 mute
boolean

是否安静模式。安静模式，则不再打印日志，在linux下，pm2就不会日志过大的占用。

1.30 showParams(args)
将当前函数的，参数，都打印出来。

1.31 syncDo(opts, end)
异步执行的封装，

对一组数组、或对象集，进行异步的操作。一切正常后，调用end返回。

1.31.1 opts

1.31.1.1 data
array | object

数组或对象集。

分别进行回调。

1.31.1.2 callback(onedata, end)
单个回调

这里可以执行用户的代码。最后使用end，表示程序执行完成。

end一定要调用。

1.31.1.2.1 onedata
有两种情况，

如果data是数组，则这里的onedata，是单个数组里的元素。

如果data是属性集。则这里的onedata是：

{

key: "属性名称",

val: "属性内容"

}

1.31.2 end(err)
最终回调

如果程序正常，则err为空

1.32 ?valueCheck(jData, jRules, end)
(还在考虑，要不要加这么一个判断函数)

对一个jData对象里面的属性，根据jRules规则进行判断。

如果不合规，则end({message:"错误信息"})，
合规，则end(null)

1.32.1 jData
object

任意包含属性的对象

1.32.2 jRules
规则对象

这里存在的key，必须是要包含的。

二、网络

2.1 ajax(url, jOpts)
向服务器请求一个资源，异步无刷新。

2.1.1 url
string

请求的地址，如："http://baidu.com/do.php"

2.1.2 jOpts
JSON

一个配置参数集合。

2.1.2.1 success(body, jOpts)
function

成功返回的回调函数

2.1.2.1.1 body
string

请求获得的文本内容

2.1.2.1.2 jOpts
JSON

就是自己的这个请求体

2.1.2.1.2.1 jOpts
JSON

一个配置参数集合。

2.1.2.2 error(msg)
function

出错后的回调，用户定义函数

2.1.2.2.1 msg
string

错误的内容信息

2.1.2.3 type
string

指明返回的类型，目前支持script和html等等

script，会自动成为GET方式

其他形式，则可定义为POST或GET。

2.1.2.4 timeout
number

设置最大超时时间

2.1.2.5 method
string

提交的方式，有"GET"或"POST"

2.1.2.6 cache
boolean

是否使用缓存，默认false

2.1.2.7 data
JSON

要提交的key=value的数据。

2.1.2.8 sync
boolean

是否为异步，默认为true

2.1.2.9 contentType
string

提交数据的方式。可以设置数据情况，编码格式等等。

例如：

"application/x-www-form-urlencoded; charset=utf-8"

上面是默认值。

application/json;

text/plain （上传键值对）

application/x-www-form-urlencoded （上传数据流。默认）

text/plain或application/json时，在chrome里显示上传类型为：request payload

application/x-www-form-urlencoded 时，在chrome里显示上传类型为：from data。

2.2 getParam(sKey)
得到一个查询字串的值，

这个查询字串，可以是?后的内容，也可以是#后面的内容

如：

http://url.com/?key=123#name=jack

getParam("key") = 123

getParam("name") = jack

三、浏览器DOM相关

3.1 dom(jOpts)
fun.dom(...)

查找某个对象

与jQuery与互补

3.1.1 jOpts
JSON / String

当是String时，会认为这个String为ID，而会返回这个对象。
如果是JSON，则有更复杂的逻辑，来查找一个或多个对象。

3.1.1.1 obj / tagObj
DOM

在哪个对象基本上查找

3.1.1.2 seek
String

查找什么

可以指定是哪一种类型的，如

"DIV"，"SPAN"等等

也可以设为“*”，则去查找所有子对象

也可以设为“+”，则只查找当前子层的对象

也可以设为“^”，则，如果要只查找一个，就不再向它的子层查找。这在多重继承的对象，非常有用。

3.1.1.3 index
Number

当查找某个seek为DIV时，再设置一个数字index，则只返回这个index的对象

3.1.1.4 limit
Number

当seek为*时，则可要求只显示前面的limit个。反边的不返回。

3.1.1.5 attr
String / JSON

对象属性值。

3.1.1.5.1 String
Stirng

如：