str_Repeat函数
函数名:wb_重复文本 / str_Repeat
函数功能
将指定的文本重复若干次,生成一个新的重复文本字符串。
参数规范
| 参数名 | 类型 | 必填 | 示例 | 特殊说明 |
|---|---|---|---|---|
input | String | 是 | "abc" | 需要被重复的文本 |
count | Integer | 是 | 3 | 重复的次数,必须大于0 |
使用案例
3.1 基本文本重复
问题描述:将文本重复多次 公式演示:
excel
=str_Repeat("abc", 3)输出效果:
text
abcabcabc3.2 次数为0或负数
问题描述:重复次数为0或负数时返回空字符串 公式演示:
excel
=str_Repeat("abc", 0)输出效果:
text
技术说明
4.1 重复机制
- 使用
Enumerable.Repeat对文本进行重复拼接。 - 当
count小于等于0时,返回空字符串。
4.2 异常处理
| 错误场景 | 返回值 |
|---|---|
| 非法重复次数(负数) | 空字符串 |
| 运行异常 | 返回错误信息文本,如"错误: 异常描述" |
扩展应用
6.1 结合字符串拼接
excel
=str_Repeat("A-", 5) & "END"6.2 构造重复格式文本
excel
=str_Repeat("=", 10)输出示例:
text
==========注:本函数在WPS 2019+和Excel 365中测试通过