str_Fill函数

函数名：wb_文本填充 / str_Fill

函数功能

对指定文本进行填充操作，使其达到指定的总长度。支持左侧或右侧填充，自定义填充字符。

参数规范

参数名	类型	必填	示例	特殊说明
input	String	是	"abc"	原始文本
totalWidth	Integer	是	8	填充后的总长度
paddingChar	String	否	"*"	用于填充的字符，默认空格
leftPadding	Boolean	否	TRUE	是否左侧填充，TRUE为左侧填充，FALSE为右侧填充，默认左侧填充

使用案例

3.1 左侧填充默认字符

问题描述：左侧用空格填充，使总长度达到8 公式演示：

=str_Fill("abc", 8)

输出效果：

     abc

3.2 右侧填充指定字符

问题描述：右侧用字符*填充，使总长度达到6 公式演示：

=str_Fill("abc", 6, "*", FALSE)

输出效果：

abc***

3.3 填充字符为空自动替换为空格

问题描述：填充字符传入空字符串时，自动使用空格填充 公式演示：

=str_Fill("abc", 5, "")

输出效果：

  abc

技术说明

4.1 填充实现

• 使用.NET自带的PadLeft和PadRight方法完成填充
• 默认填充字符为空格，当paddingChar为空时自动替换

4.2 异常处理

错误场景	返回值
填充字符为空	自动替换为空格
运行异常	返回错误信息文本，如"错误: 异常描述"

扩展应用

6.1 格式化数字或文本对齐

=str_Fill(A1, 10, "0", TRUE)  // 左侧用0填充，宽度10

6.2 生成定长标识符

=str_Fill("ID123", 8, "-", FALSE)  // 右侧用-填充，宽度8

注：本函数在WPS 2019+和Excel 365中测试通过