格式化字符串

格式化字符串 节点使用与 Python 兼容的字符串格式语法或 Blender 的格式指定符语法将值插入字符串。

该节点简化了字符串的构造，无需将数字转换为字符串或使用多个连接节点，即可对数值进行组合与格式化。

See also

Python 语法参考：- Python 格式字符串语法 - {fmt} 格式字符串语法

输入

格式

采用 Python 格式样式或 Blender 格式规范的字符串。例如，Count: {} 会将第一个输入值插入到 {} 的位置。

其他输入值（浮点数、整数或字符串）可在侧栏的格式化项目列表中进行管理。

属性

格式化项目

一个列表视图，用于管理格式化字符串中动态输入项的列表。每个条目对应一个可通过占位符插入格式中的值。请参阅输入命名行为了解输入项的命名规则。

接口类型

该输入值的类型：

浮点:

浮点数（例如 3.14）。

整数:

整数（例如 42）。

字符串:

文本字符串。

输出

字符串

格式化的字符串。

注意

• 支持未命名（{}）和命名（{name}）占位符。但所有未命名占位符必须位于任何命名占位符之前。

• 仅支持浮点数、整数和字符串类型的输入。

• 不支持 Python 样式的转换，例如 !r．

• 不支持子属性访问，例如 {vector.x}．

• 不支持基于百分比的格式，例如 %d、%s．

• 不支持使用 #（如 {:#x}）的替代形式指定符。

• 不支持使用 L（如 fmt 库中的）进行基于区域的格式化。

• 不支持千位分隔符（如 {:,} 或 {:_}）等分组选项。

输入命名行为

每个输入必须具有唯一且有效的标识符名称，用于占位符（例如 {value}）。该节点采用特殊逻辑自动为新输入分配名称：

• 若已连接，则使用链接接口名称的首字符。

• 否则，名称默认为字母 a 至 z．

• 必要时，原始接口名称将转换为有效标识符。

• 若其他方法均告失败，则添加一个唯一后缀（如 _001、_002）。

Important

输入名称必须是有效的标识符且必须唯一。若名称无效，格式化操作可能失败或产生错误输出。

示例

基础

• 格式：Count: {}

• 输入：值为 5 的整数

• 结果：Count: 5

多个值

• 格式：X: {}, Y: {}

• 输入：浮点数 1.5, 浮点数 2.0

• 结果：X: 1.5, Y: 2.0

已命名的输入

• 格式：Size: {width} x {height}

• 输入：width=1920, height=1080

• 结果：Size: 1920 x 1080

填充编号

• 格式：Frame_{:04}

• 输入：整数 12

• 结果：Frame_0012

编号格式（模板样式）

• 格式：##.00

• 输入：浮点数 3.1415

• 结果：03.14

带帧编号的路径

• 格式：/output/image_{:04}.png

• 输入：整数 42

• 结果：/output/image_0042.png