字符串处理艺术：StrUtil和CharUtil的字符串操作指南
项目地址: https://gitcode.com/tongzhanglao/harmony-utils 还在为HarmonyOS应用开发中的字符串处理而烦恼吗？面对各种复杂的字符串操作需求，你是否经常编写重复的验证代码？本文将为你介绍harmony-utils工具库中StrUtil和CharUtil的强大功能，助你轻松应对各种字符串处理挑战！
读完本文，你将掌握：
- 字符串空值检测的完整解决方案
- 字符类型判断的精准方法
- 字符串转换与编码处理技巧
- 实际开发中的最佳实践案例
字符串处理的重要性
在HarmonyOS应用开发中，字符串处理是最基础也是最频繁的操作之一。从用户输入验证到数据格式化，从文本处理到编码转换，字符串操作贯穿整个开发流程。一个优秀的字符串工具库能够显著提升开发效率和代码质量。
StrUtil：全能字符串处理工具
空值检测与验证
StrUtil提供了完整的空值检测体系，帮助开发者避免常见的空指针异常：
// 基础空值检测
const isNull = StrUtil.isNull(undefined); // true
const isNotNull = StrUtil.isNotNull("hello"); // true
// 空字符串检测
const isEmpty = StrUtil.isEmpty(""); // true
const isNotEmpty = StrUtil.isNotEmpty("text"); // true
// 空白符检测（包括空格、制表符等）
const isBlank = StrUtil.isBlank(" "); // true
const isNotBlank = StrUtil.isNotBlank("content"); // true
字符串清理与格式化
// 去除两端空格
const trimmed = StrUtil.trim(" hello world "); // "hello world"
// 去除所有空格
const noSpaces = StrUtil.trimAll("hello world"); // "helloworld"
// 安全转换为字符串
const safeStr = StrUtil.toStr(null, "default"); // "default"
const numberStr = StrUtil.toStr(123); // "123"
字符串操作与匹配
// 字符串替换
const replaced = StrUtil.replace("hello world", "world", "harmony"); // "hello harmony"
const allReplaced = StrUtil.replaceAll("aabbcc", "b", "x"); // "aaxxcc"
// 首尾匹配判断
const startsWith = StrUtil.startsWith("harmonyOS", "harmony"); // true
const endsWith = StrUtil.endsWith("app.ets", ".ets"); // true
// 字符串重复
const repeated = StrUtil.repeat("na", 3); // "nanana"
大小写转换
// 大小写转换
const lower = StrUtil.toLower("HELLO"); // "hello"
const upper = StrUtil.toUpper("hello"); // "HELLO"
const capitalized = StrUtil.capitalize("hARMONY"); // "Harmony"
编码转换与数据处理
StrUtil提供了丰富的编码转换功能，支持多种数据格式互转：
具体使用方法：
// 字符串与Uint8Array互转
const uint8Array = StrUtil.strToUint8Array("hello");
const backToString = StrUtil.unit8ArrayToStr(uint8Array);
// Base64编码解码
const base64 = StrUtil.strToBase64("secret data");
const original = StrUtil.base64ToStr(base64);
// 16进制转换
const hexArray = StrUtil.strToHex("68656c6c6f");
const hexString = StrUtil.hexToStr(hexArray);
// ArrayBuffer转换
const buffer = StrUtil.strToBuffer("data");
const strFromBuffer = StrUtil.bufferToStr(buffer);
错误处理工具
// 错误信息格式化
const error = new BusinessError();
error.code = 401;
error.message = "Unauthorized";
const errorStr = StrUtil.getErrorStr(error);
// 输出: {"name":"BusinessError","code":401,"message":"Unauthorized","stack":""}
// 系统错误码解析
const errorDesc = StrUtil.getErrnoToString(2); // "No such file or directory"
CharUtil：精准字符类型判断
CharUtil专注于字符级别的类型判断，基于HarmonyOS的i18n.Unicode模块提供准确的字符分类：
字符类型检测
// 数字检测
const isDigit = CharUtil.isDigit("5"); // true
const isNotDigit = CharUtil.isDigit("a"); // false
// 字母检测
const isLetter = CharUtil.isLetter("A"); // true
const isNotLetter = CharUtil.isLetter("1"); // false
// 大小写检测
const isLower = CharUtil.isLowerCase("a"); // true
const isUpper = CharUtil.isUpperCase("A"); // true
// 空白符检测
const isSpace = CharUtil.isSpaceChar(" "); // true
const isWhitespace = CharUtil.isWhitespace("\t"); // true
特殊字符判断
// 从右到左语言字符
const isRTL = CharUtil.isRTL("א"); // true (希伯来语字符)
// 表意文字
const isIdeograph = CharUtil.isIdeograph("汉"); // true
// ASCII字符
const isAscii = CharUtil.isAscii("A"); // true
const isNotAscii = CharUtil.isAscii("中文"); // false
空白符综合判断
// 综合空白符检测（包括特殊空白字符）
const isBlankChar = CharUtil.isBlankChar(0xFEFF); // true (零宽不折行空格)
const isBlankChar2 = CharUtil.isBlankChar(0x202A); // true (从左到右嵌入)
实战应用场景
场景一：用户输入验证
// 综合验证函数
function validateUserInput(input: string): ValidationResult {
if (StrUtil.isBlank(input)) {
return { valid: false, message: "输入不能为空" };
}
if (input.length < 6) {
return { valid: false, message: "长度至少6位" };
}
// 检查是否包含数字和字母
let hasDigit = false;
let hasLetter = false;
for (const char of input) {
if (CharUtil.isDigit(char)) hasDigit = true;
if (CharUtil.isLetter(char)) hasLetter = true;
}
if (!hasDigit || !hasLetter) {
return { valid: false, message: "必须包含数字和字母" };
}
return { valid: true, message: "验证通过" };
}
场景二：数据格式化处理
// 数据清洗和格式化
function formatUserData(rawData: string): string {
// 去除多余空格
let cleaned = StrUtil.trimAll(rawData);
// 移除特殊字符（只保留字母、数字、中文）
cleaned = StrUtil.replaceAll(cleaned, /[^\w\u4e00-\u9fa5]/g, "");
// 首字母大写
return StrUtil.capitalize(cleaned);
}
场景三：安全数据处理
// 安全的数据编码传输
function secureDataTransfer(data: string): TransferData {
const encoded = StrUtil.strToBase64(data);
const checksum = StrUtil.strToHex(encoded).length;
return {
payload: encoded,
checksum: checksum,
timestamp: Date.now()
};
}
// 数据接收和解码
function receiveSecureData(transferData: TransferData): string {
if (StrUtil.strToHex(transferData.payload).length !== transferData.checksum) {
throw new Error("数据校验失败");
}
return StrUtil.base64ToStr(transferData.payload);
}
性能优化建议
1. 避免不必要的字符串操作
// 不推荐：多次调用trim
function processInput(input: string): string {
let result = StrUtil.trim(input);
result = StrUtil.toLower(result);
result = StrUtil.replaceAll(result, " ", "_");
return result;
}
// 推荐：链式操作或一次性处理
function processInputOptimized(input: string): string {
return StrUtil.trim(input)
.toLowerCase()
.replaceAll(" ", "_");
}
2. 合理使用编码转换
// 对于大量数据处理，使用Buffer操作更高效
function processLargeData(data: string): void {
const buffer = StrUtil.strToBuffer(data);
// 在Buffer层面进行操作
const processedBuffer = processBuffer(buffer);
const result = StrUtil.bufferToStr(processedBuffer);
}
3. 缓存常用操作结果
// 缓存字符类型判断结果
const charTypeCache = new Map<string, boolean>();
function isSpecialChar(char: string): boolean {
if (charTypeCache.has(char)) {
return charTypeCache.get(char);
}
const isSpecial = CharUtil.isIdeograph(char) || CharUtil.isRTL(char);
charTypeCache.set(char, isSpecial);
return isSpecial;
}
兼容性考虑
StrUtil和CharUtil基于HarmonyOS API 12+开发，确保在支持的设备上稳定运行。主要依赖的模块包括：
@ohos.util：提供文本编码解码功能@kit.ArkTS：提供Buffer操作支持@kit.LocalizationKit：提供Unicode字符分类
总结对比
为了帮助你更好地选择使用场景，以下是StrUtil和CharUtil的功能对比表：
| 功能类别 | StrUtil | CharUtil | 适用场景 |
|---|---|---|---|
| 空值检测 | ✅ 完整支持 | ❌ 不支持 | 输入验证、数据清洗 |
| 字符串操作 | ✅ 丰富功能 | ❌ 不支持 | 文本处理、格式化 |
| 编码转换 | ✅ 多种格式 | ❌ 不支持 | 数据存储、网络传输 |
| 字符类型判断 | ❌ 不支持 | ✅ 精准判断 | 输入验证、文本分析 |
| Unicode支持 | 有限支持 | ✅ 完整支持 | 国际化应用 |
| 性能特点 | 面向字符串操作 | 面向字符判断 | 根据需求选择 |
最佳实践指南
- 输入验证优先：在处理用户输入前，始终使用
StrUtil.isBlank()进行空值检查 - 字符级验证：对于密码强度等需求，结合使用CharUtil进行字符类型验证
- 编码一致性：在网络传输和数据存储时，统一使用Base64或16进制编码
- 错误处理：利用
StrUtil.getErrorStr()规范化错误信息输出 - 性能监控：对于大量字符串操作，监控性能并适时优化
通过掌握StrUtil和CharUtil的强大功能，你将能够轻松应对HarmonyOS应用开发中的各种字符串处理需求，提升代码质量和开发效率。现在就开始在你的项目中实践这些技巧吧！
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
