Richang.js

//      ___                       ___           ___           ___           ___           ___
//     /\  \                     /\__\         /\  \         /\  \         /\  \         /\__\
//    /::\  \       ___         /:/  /         \:\  \       /::\  \        \:\  \       /:/ _/_
//   /:/\:\__\     /\__\       /:/  /           \:\  \     /:/\:\  \        \:\  \     /:/ /\  \
//  /:/ /:/  /    /:/__/      /:/  /  ___   ___ /::\  \   /:/ /::\  \   _____\:\  \   /:/ /::\  \
// /:/_/:/__/___ /::\  \     /:/__/  /\__\ /\  /:/\:\__\ /:/_/:/\:\__\ /::::::::\__\ /:/__\/\:\__\
// \:\/:::::/  / \/\:\  \__  \:\  \ /:/  / \:\/:/  \/__/ \:\/:/  \/__/ \:\~~\~~\/__/ \:\  \ /:/  /
//  \::/~~/~~~~   ~~\:\/\__\  \:\  /:/  /   \::/__/       \::/__/       \:\  \        \:\  /:/  /
//   \:\~~\          \::/  /   \:\/:/  /     \:\  \        \:\  \        \:\  \        \:\/:/  /
//    \:\__\         /:/  /     \::/  /       \:\__\        \:\__\        \:\__\        \::/  /
//     \/__/         \/__/       \/__/         \/__/         \/__/         \/__/         \/__/
//
//
//                日常
//        +-------------------+
//        |   Richang  JSEX   |
//        +-------------------+

Install

npm i -S richang.js

不使用 Node 相关模块

// ES6 modules
import Richang from "richang.js"
 
// Node.js (CJS) modules
var Richang =  require ("richang.js")
 
// 载入纯 ES6 modules
import Richang from "richang.js/dist/RichangEs.js"
 
// 捆绑了所有 node_modules 依赖
import Richang from "richang.js/dist/RichangEs.bundle.js"

使用 Node 相关模块

// 依赖在 node_modules 中
var Richang =  require ("richang.js/dist/RichangNode.js")
 
// 捆绑了所有 node_modules 依赖(bable 目标 Node 1.2 的模块, transform-runtime)
var Richang =  require ("richang.js/dist/RichangNode.bundle.js")
 
// 如果项目没有使用 babel, 可能需要单独使用 babel-polyfill
require("babel-polyfill")
var Richang =  require ("richang.js/dist/RichangNode.bundle.js")

如果遇到 ReferenceError: regeneratorRuntime is not defined ，需要安装 npm i -S babel-polyfill ，并且在引入 Richang.js 前先引入 babel-polyfill

Members

Time : Object: 时间日期操作相关模块
byteToHex: Convert array of 16 byte values to UUID string format of the form: XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX
Tool : Object: 通用工具相关模块
NodeFile : Object: 文件操作相关模块
NodeDebug : Object: Node 调试相关模块
NodeImage : Object: Node 图片相关模块
NodeTool : Object: Node 通用工具
ConsoleCON : Object: 控制台相关功能模块
ObjectOBJ : Object: 对象操作相关操作
StringSTR : Object: 字符串相关功能模块
Rect : Object: 矩形处理相关模块
TypeTYP : Object: 类型相关模块
AarryArr : Object: 数组相关功能模块
Calc : Object: 计算相关功能模块
FileFIL : Object: 文件操作相关模块
Cache : Object: 缓存相关

Time : `Object`

时间日期操作相关模块

Kind: global variable

Time : Object
- .genTimestamp([raw])
- .parseTimestamp(timestamp) ⇒ Date

Time.genTimestamp([raw])

生成时间戳（当前时间的 32 进制）

Kind: static method of Time

Param	Type	Description
[raw]	`Object`	获取原始格式，比如 1521602474428

Time.parseTimestamp(timestamp) ⇒ `Date`

解析一个时间戳返回 date

Kind: static method of Time

Param
timestamp

byteToHex

Convert array of 16 byte values to UUID string format of the form: XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX

Kind: global variable

Tool : `Object`

通用工具相关模块

Kind: global variable

Tool : Object
- .genUUID_v4() ⇒ string
- .genUUID_v5(name, [namespace]) ⇒ *
- .genSHA1(str) ⇒ *
- .formatUUID(str) ⇒ string
- .checkUUID(uuid) ⇒ number
- .roll(max, min)
- .rollString(length, [dict]) ⇒ string

Tool.genUUID_v4() ⇒ `string`

生成一个随机的 UUID

genUUID_v4() => 'f8061fba-842b-4cc5-9872-9348e2e06916'

Kind: static method of Tool

Tool.genUUID_v5(name, [namespace]) ⇒ `*`

根据一个名字和命名空间生成一个 UUID，这个 UUID 与名称+命名空间有一一对应，不随机（与标准不同，这里命名空间可不用 UUID 而是任何字符串，我们会用默认 UUID 和给命名空间生成一个 UUID）

genUUID_v5("Gasoft_Mobiusbug.exe","BGLL") => '2cb20c42-026f-5d56-b33f-008e354ac8d3'

Kind: static method of Tool

Param	Type	Description
name	`string`	名称
[namespace]	`string`	命名空间,

Tool.genSHA1(str) ⇒ `*`

用 sha1 生成一个字符串

genSHA1("nullice") => 51918a176c8e2b0af211a94c5478c58a54f239cd

Kind: static method of Tool

Param	Type
str	`string`

Tool.formatUUID(str) ⇒ `string`

把36位字符串转换成带横杠 UUID 的格式

formatUUID("e9411a6f1a2e22dd2244b78ee491c616") => "e9411a6f1a2e22dd2244b78ee491c616"

Kind: static method of Tool

Param	Type
str	`string`

Tool.checkUUID(uuid) ⇒ `number`

检查一个字符串是 UUID 的版本或者是否是 UUID，返回 UUID 的版本，如果为 0 则说明不是 UUID

Kind: static method of Tool

Param	Type	Description
uuid	`string`	uuid

Tool.roll(max, min)

生成一个随机整数

Kind: static method of Tool

Param	Type	Description
max	`number`	最大值
min	`number`	最小值

Tool.rollString(length, [dict]) ⇒ `string`

生成一个随机字符串

Kind: static method of Tool

Param	Type	Description
length	`number`	随机字符串长度
[dict]	`string`	随机字符字典，默认为 a—Z0-9

NodeFile : `Object`

文件操作相关模块

Kind: global variable

NodeFile.getTempDirManager(name) ⇒ `*`

生成一个临时文件夹管理器，会在系统临时目录中创建一个指定名字的临时文件夹，和一个实例临时文件夹可以用得到的 TempDirManager，申请临时文件名，和销毁临时文件夹

var tepmDM = getTempDirManager("siphonink") tepmDM.genTempFilePath(subDir) - 申请一个临时文件路径,可用提供一个子文件夹名 tepmDM.destroy() - 销毁临时目录 tepmDM.clear(day) - 清除 day 天前的实例临时文件夹

Kind: static method of NodeFile

Param
name

NodeDebug : `Object`

Node 调试相关模块

Kind: global variable

NodeDebug : Object
- .logRed(text)
- .cRed(text) ⇒ string | *
- .logBlue(text)
- .cBlue(text) ⇒ * | string
- .logGreen(text)
- .cGreen(text) ⇒ string | *
- .logGray(text)
- .cGray(text) ⇒ string | *
- .logYellow(text)
- .cYellow(text) ⇒ string | *
- .logLableRed(text)
- .logLableYellow(text)
- .logLableCyan(text)
- .logLableGreen(text)
- .logLableWhite(text)