前言字符串空值判断是开发中最常见的操作之一null、undefined、空字符串、纯空格等都需要处理。pura/harmony-utils的StrUtil封装了丰富的字符串判断方法。本文将从API说明、代码实战、进阶用法、常见问题等多个维度进行全面讲解帮助开发者快速掌握并应用到实际项目中。一、StrUtil判断核心APIStrUtil提供了以下字符串判断方法方法说明返回类型使用场景isEmpty(str)是否为空boolean空值检查isNotEmpty(str)是否非空boolean非空判断isBlank(str)是否空白boolean空白检查isNotBlank(str)是否非空白boolean有效内容isNullOrUndefined(str)是否null或undefinedboolean类型检查1.1 核心特性简洁易用封装复杂逻辑为一行调用降低使用门槛类型安全完整的TypeScript类型定义编译期即可发现错误异常处理内置异常捕获机制避免运行时崩溃全面覆盖覆盖null、undefined、空字符串、纯空格等场景1.2 isEmpty与isBlank对比输入isEmptyisBlanknulltruetrueundefinedtruetruetruetrue falsetruehellofalsefalse二、完整使用步骤2.1 安装依赖ohpminstallpura/harmony-utils2.2 空值判断import{StrUtil}frompura/harmony-utils;Button(isEmpty判断).width(100%).onClick((){try{letr1StrUtil.isEmpty();letr2StrUtil.isEmpty(null);letr3StrUtil.isEmpty(hello);this.resultisEmpty():${r1}\nisEmpty(null):${r2}\nisEmpty(hello):${r3};}catch(e){this.result异常: e;}})2.3 空白判断Button(isBlank判断).width(100%).onClick((){try{letr1StrUtil.isBlank();letr2StrUtil.isBlank( );letr3StrUtil.isBlank(hello);this.resultisBlank():${r1}\nisBlank( ):${r2}\nisBlank(hello):${r3};}catch(e){this.result异常: e;}})三、完整页面示例import{StrUtil}frompura/harmony-utils;EntryComponentstruct StrEmptyDemo{Stateresult:string;build(){Column({space:12}){Button(isEmpty测试).width(100%).onClick((){letr1StrUtil.isEmpty();letr2StrUtil.isEmpty(hello);this.resultisEmpty():${r1}, isEmpty(hello):${r2};});Button(isBlank测试).width(100%).onClick((){letr1StrUtil.isBlank( );letr2StrUtil.isNotBlank( hello );this.resultisBlank( ):${r1}, isNotBlank( hello ):${r2};});Text(this.result).fontSize(14).fontColor(#333333)}.padding(16)}}四、进阶用法4.1 表单校验import{StrUtil,ToastUtil}frompura/harmony-utils;functionvalidateForm(name:string,phone:string):boolean{if(StrUtil.isBlank(name)){ToastUtil.show(请输入姓名);returnfalse;}if(StrUtil.isBlank(phone)){ToastUtil.show(请输入手机号);returnfalse;}returntrue;}4.2 安全取值functionsafeGetString(value:string|null|undefined,defaultVal:string):string{returnStrUtil.isNotBlank(value)?value!:defaultVal;}五、注意事项null安全StrUtil方法对null和undefined安全不会抛异常空白字符isBlank会检查空格、制表符等空白字符性能优化频繁调用时建议缓存结果初始化依赖使用前需确保AppUtil.init()已调用链式调用可与其他StrUtil方法链式使用六、常见问题Q1: isEmpty和isBlank有什么区别isEmpty只检查null/undefined/空字符串isBlank还会检查纯空格字符串。Q2: isNullOrUndefined什么时候用当只需要判断是否为null或undefined不关心空字符串时使用。Q3: 中文空格算空白吗是的全角空格也属于空白字符isBlank会返回true。Q4: 如何判断字符串是否只有数字请使用RegexUtil.isNumber()方法。总结StrUtil的字符串判断方法为空值检查提供了便捷支持。本文详细介绍了核心API、使用步骤、完整示例、进阶用法以及常见问题的解决方案。开发者可以利用这些方法简化表单校验和安全取值等操作。本文基于pura/harmony-utils工具库更多功能请参考官方文档与后续系列文章。
)
