虚幻引擎 Get Number of Entries / Is Empty 节点

在虚幻引擎5中，Get Number of Entries（或Length）和Is Empty是用于数组(Array)、映射(Map) 和集合(Set) 等容器的基础节点。它们的作用分别是获取容器内元素的数量，以及检查容器是否为空。

这两个节点在不同情境下的具体操作步骤如下：

🎯 核心使用案例：数组 (Array)

数组是UE5中最常用的容器类型，这两个节点的应用也最为普遍。

1. 获取数组元素数量：Length 节点

• 节点定位：在蓝图编辑器中，从数组变量引脚拖出，搜索 Length。

• 具体操作步骤：

  1. 在蓝图的事件图表中，右键单击创建一个Length节点。

  2. 将你想要查询的数组变量连接到Length节点的输入引脚。

  3. Length节点的输出引脚（整数类型）即为该数组当前的元素个数。

2. 检查数组是否为空：Is Empty 节点

• 节点定位：在蓝图编辑器中，从数组变量引脚拖出，搜索 Is Empty。

• 具体操作步骤：

  1. 右键单击创建一个Is Empty节点。

  2. 将你的数组变量连接到它的输入引脚。

  3. 它的输出引脚（布尔类型）会返回True（如果数组为空）或False（如果数组不为空）。

3. 综合应用：背包系统示例

假设你正在制作一个背包系统，希望当背包为空时显示“背包为空”的提示，否则显示物品数量。

1. 创建变量：创建一个名为InventoryArray的数组变量，类型为Item（自定义结构体或类）。

2. 构建蓝图：

   • 在事件图表中，从InventoryArray拖出，创建 Is Empty 节点，并连接到一个分支(Branch) 节点。

   • 在分支节点的True执行引脚上，连接一个打印字符串(Print String) 节点，内容设为“背包为空”。

   • 在分支节点的False执行引脚上，从InventoryArray拖出创建 Length 节点，将其返回值（物品数量）转换为字符串后，用Print String打印出来。

📚 其他容器与组件中的应用

除了数组，这两个节点或其变体也广泛用于其他数据结构。

• 映射(Map)：对于Map容器，同样可以使用 Length 和 Is Empty 节点来获取键值对的数量或判断其是否为空。

• 动态入口盒 (Dynamic Entry Box)：在UMG（UI）设计中，Dynamic Entry Box组件用于动态创建UI控件。可以使用 Get Num Entries 节点来获取当前已创建的控件数量。

• 过程化内容生成 (PCG)：在PCG图表中，Get Number of Entries 节点专门用于获取PCG元数据中的条目数量。

⚠️ 注意事项

• 区分“空”与“无效”：Is Empty节点检查的是容器是否不包含任何元素。这与检查一个变量是否为null或None是不同的概念。一个数组变量可以是有效的（不为None），但内部元素个数为0，此时Is Empty返回True。

• 节点命名差异：在不同的上下文中，获取元素数量的节点名称可能略有不同，例如Length、Num、Get Number of Entries或Get Num Entries。但它们在各自上下文中的核心功能是一致的。

💎 总结

掌握Get Number of Entries（Length）和Is Empty节点是进行UE5蓝图逻辑开发的基础。你可以将它们灵活运用于数组、集合、映射乃至UI和PCG系统中，实现数据校验、流程控制和动态逻辑。

感谢您的来访，获取更多精彩文章请收藏本站。