文本填充
函数名：wb_文本填充 / str_Fill
功能描述
对文本进行左侧或右侧填充，使用指定字符将文本补齐到指定的总长度。适用于固定宽度排版、编码补零、对齐输出等场景。
会员等级：🟢 免费版（Free）
语法
excel
=str_Fill(文本, 总长度, 填充字符, 填充位置)参数
| 参数名 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
| 文本 | String | 是 | 无 | 原始文本 |
| 总长度 | Int | 是 | 无 | 填充后的总长度 |
| 填充字符 | String | 否 | " "（空格） | 用于填充的字符，取第一个字符生效 |
| 填充位置 | Boolean | 否 | TRUE | TRUE=左侧填充，FALSE=右侧填充 |
返回值
String - 填充到指定长度后的文本。若原文本长度已达到或超过总长度，则原样返回。
使用示例
左侧补零
公式：
excel
=str_Fill("42", 5, "0", TRUE)结果：
00042右侧填充空格
公式：
excel
=str_Fill("姓名", 6, " ", FALSE)结果：
姓名技术说明
- 内部调用 .NET 的
string.PadLeft或string.PadRight方法实现填充 - 填充字符参数取字符串的第一个字符（
paddingChar[0]）作为实际填充字符 - 若填充字符参数为空或 null，自动回退为空格字符
- 当原文本长度大于等于总长度时，不进行任何填充，原样返回
错误处理
| 错误场景 | 返回值 |
|---|---|
| 填充字符为空或 null | 使用空格填充后返回 |
| 原文本长度 >= 总长度 | 原文本原样返回 |
| 处理过程中发生异常 | "错误: {异常信息}" |