字符串填充

📖 节点概述

对字符串进行填充，使其达到指定的总长度。支持左填充（右对齐）、右填充（左对齐）和居中填充三种方式。输入可以是单个字符串、字符串列表或多行文本（自动按行拆分），输出类型根据输入行数动态变化：单行返回字符串，多行返回字符串列表。该节点为纯数据节点，无执行端口。

💡 使用场景：

• 表格对齐：生成固定宽度的文本列，用于控制台输出或日志格式化。
• 数字补零：将数字转换为固定位数（如 "5" → "0005"）。
• 文本美化：在标题或分割线两侧添加对称填充字符（居中填充）。
• 批量格式整理：对多行文本统一进行填充对齐。
• 代码/数据生成：生成固定格式的记录文件（如固定字段宽度）。

🎮 实战连线指南：如何正确使用它？

节点有输入端口 文本、目标长度、填充字符，以及输出端口 结果。通过“方向”下拉框选择填充方式。

场景案例：将数字补零到 5 位（左填充）

1. 获取数字：从【变量获取】节点读取 order_id = 42。
2. 连接节点：将 order_id 连入【字符串填充】的 文本。
3. 设置目标长度：在“目标长度”中输入 5（或连线提供）。
4. 设置填充字符：在“填充字符”中输入 0。
5. 选择方向：左填充。
6. 获取结果：结果 输出 "00042"（字符串类型）。

场景案例：对多行文本进行右填充，统一宽度

• 文本（多行）：

  Apple
  Banana
  Cherry
  

• 目标长度：8
• 填充字符：.（点号）
• 方向：右填充
• 结果（列表）：

  ["Apple...", "Banana..", "Cherry.."]
  

居中填充示例：

• 文本 "Hello"，目标长度 9，填充字符 -，居中填充 → "--Hello--"（两侧填充数量相差可能为 1，左侧少右侧多）。

⚙️ 引脚与参数说明

📥 输入引脚

⚙️ 控件参数

📤 输出引脚

🔧 填充规则说明

• 如果目标长度 ≤ 原字符串长度，则返回原字符串（不做截断）。
• 左填充：使用 字符串.rjust(目标长度, 填充字符)。
• 右填充：使用 字符串.ljust(目标长度, 填充字符)。
• 居中填充：使用 字符串.center(目标长度, 填充字符)，无法全部平分时左侧少一个填充字符。
• 填充字符只取首个字符（若输入空字符串，则默认使用空格 ' '）。

⚠️ 注意事项

• 填充字符长度限制：仅使用首个字符。例如输入 "abc" 只会用 'a' 填充。
• 目标长度过小：不会截断原始字符串，只返回原值。
• 多行输入识别：
  • 连线传入列表：逐项处理，返回列表。
  • 控件多行文本框：按行拆分（空行会被保留为空字符串并填充）。
  • 数字等非字符串：转换为字符串后视为单行。
• 输出类型动态变化：
  • 设计期：根据文本框初始内容行数确定端口类型（单行 → STRING，多行 → LIST）。
  • 运行期：根据实际输入的行数动态调整输出端口类型，确保下游连线兼容。
• 性能：处理大量行时，每行独立填充，时间复杂度 O(N*L)（L 为目标长度）。

💎 小贴士：

• 常见数字补零可以直接使用“左填充”，填充字符 0。
• 如果需要截断超长字符串，可以配合【截断保留小数】或【字符串切片】节点先处理。
• 居中填充常用于生成装饰性标题（如 -- 标题 --）。
• 与【字符串去除空格】组合使用，可以在填充前先清理原始数据。
• 输出为列表时，可配合【列表转文本】节点将结果重新合并为带换行符的字符串。