System.String 字符串处理工具类参考手册
system.string 对象提供了一系列高效的字符串处理方法，旨在简化常见的文本操作、格式转换及安全过滤任务。以下是该工具类的详细功能说明与使用指南。
方法汇总
| 方法名称 | 返回值类型 | 功能描述 |
|---|---|---|
isBlank(inputStr) |
Boolean | 判断字符串是否为空或未定义。 |
trim(inputStr) |
String | 移除字符串首尾的空白字符。 |
clearLeftChar(source, char) |
String | 从左侧移除指定的字符。 |
clearRightChar(source, char) |
String | 从右侧移除指定的字符。 |
clearBothChar(source, char) |
String | 从两侧移除指定的字符。 |
clearBlankLine(content) |
String | 过滤文本中的所有空行。 |
rndChar(minLen, maxLen) |
String | 生成指定长度范围内的随机字符串。 |
cutStr(source, length, suffix) |
String | 截断字符串并追加后缀。 |
replace(source, oldVal, newVal, ignoreCase) |
String | 替换子字符串，支持忽略大小写。 |
split(source, delimiter, ignoreCase) |
Array | 根据分隔符将字符串拆分为数组。 |
inStr(source, target, ignoreCase) |
Number | 查找子串在源字符串中首次出现的位置。 |
mid(source, start, length) |
String | 提取指定位置和长度的子串。 |
range(target, array) |
Boolean | 检查字符串是否存在于指定的数组集合中。 |
toLowerCase(source) |
String | 将字符串转换为全小写。 |
toUpperCase(source) |
String | 将字符串转换为全大写。 |
reverse(source) |
String | 将字符串顺序反转。 |
hexToOct(hexString) |
String | 将十六进制数值转换为十进制字符串。 |
toHex(source) |
String | 将字符串转为十六进制编码（以空格分隔）。 |
filterHtml(htmlContent) |
String | 去除 HTML 标签及多余空白，提取纯文本。 |
filterJs(htmlContent) |
String | 过滤 HTML 代码中的 JavaScript 脚本块。 |
htmlEncode(content) |
String | 对 HTML 字符进行安全编码处理。 |
safeHtml(content) |
String | 生成符合安全规范的 HTML 输出。 |
ascii(source) |
String | 将内容转换为以 &#x 开头的 ASCII 编码。 |
escape(source) |
String | 执行 URL 友好的特殊字符转码。 |
sha1(source) |
String | 执行 SHA1 加密处理。 |
md5(source, bit) |
String | 执行 MD5 加密（支持 16/32/64 位）。 |
方法详解
1. 随机字符生成
' 语法：system.string.rndChar( minLength [, maxLength] )
' 示例 1: 生成固定 8 位的随机码
Dim code8 : code8 = system.string.rndChar(8)
' 示例 2: 生成长度在 6 到 12 之间的随机码
Dim codeRange : codeRange = system.string.rndChar(6, 12)
2. 字符串截断
' 语法：system.string.cutStr( text, limitLen, suffix )
' 描述：如果 text 长度超过 limitLen，则截断并添加 suffix（默认为 "..."）
Dim summary : summary = system.string.cutStr("这是一个非常长的测试段落", 5, "...")
' 结果: "这是一个..."
3. 子串替换与查找
' 语法：system.string.replace( source, find, repl, ignoreCase )
Dim result : result = system.string.replace("Hello World", "world", "Developer", True)
' 结果: "Hello Developer"
' 语法：system.string.inStr( source, find, ignoreCase )
Dim pos : pos = system.string.inStr("Apple, Orange", "orange", True)
' 结果: 8
4. HTML 与安全性处理
' 过滤 HTML 标签提取纯正文
Dim rawText : rawText = system.string.filterHtml("<div>Hello World</div>")
' 结果: "Hello World"
' 安全编码，防止 Null 引用报错
Dim safeVal : safeVal = system.string.htmlEncode(Request.Form("user_input"))
5. 字符编码转换
' 字符串转十六进制视图
Dim hexView : hexView = system.string.toHex("Hi")
' 结果: "48 69"
' 转换为 HTML 实体编码 (ASCII 格式)
Dim entityStr : entityStr = system.string.ascii("中国")
' 结果: "中国"
6. 加密算法
' MD5 加密
Dim hash32 : hash32 = system.string.md5("123456", 32)
' SHA1 加密
Dim hashSha1 : hashSha1 = system.string.sha1("my_secret_key")
