Appearance
函数
函数,是用于执行特定任务的代码块。它有助于组织代码、提高可重用性,并使代码更易于理解和维护。
函数应当是最小的任务执行单位,这也就意味着,一个函数应当只做一件事。
假设有这样一道题:假设,一个笼子中,鸭子的脚总共有40只。现有10个这样的笼子,问总共有多少只鸭子?
想计算这道题,可以分成两部分,一部分是先计算每个笼子中有多少只鸭子,一部分是计算总共有多少只鸭子。这样,我们就可以把计算每个笼子中有多少只鸭子的代码封装成一个函数,计算总共有多少只鸭子的代码封装成另一个函数。
创建函数
有两种办法创建函数,一是创建空函数,另一是将已有蓝图节点坍缩为函数
命名规范
函数的命名规范为:
- 函数名应当以动词开头,如
Add
、Multiply
等。 - 函数名应当使用驼峰命名法,如
AddTwoNumbers
、MultiplyTwoNumbers
等。 - 函数名应当使用动词短语,如
AddTwoNumbers
、MultiplyTwoNumbers
等。
不建议用中文命名,因为蓝图是跨平台使用的,中文在不同的平台可能会有不同的显示效果。
输入输出
如上图所示,可以点击添加按钮,添加输入参数和输出结果。
当添加输出结果的时候,会自动生成一个返回节点,这个节点可以用于返回结果。
如上图所示,可以通过拖拽节点,来创建参数。
如上图所示,可以在函数内部创建局部变量,但是不建议这样做,因为这样会导致代码难以理解和维护。
局部变量应当在函数内部使用,如果需要在函数外部使用,应当使用全局变量。
尽管不建议使用,但是当不得不使用局部变量的时候,也请放心大胆地去使用
上面两个图展示的是如何搜索返回节点,以及返回节点的样子
细节
如上图所示,是函数的一些细节,包括函数的名称、参数、返回值、注释等。
Description(描述):函数的描述,用于描述函数的功能和用途。
Category(类别):函数的分类,用于将函数分类,以便于查找和查找。可手动输入。
Keywords(关键字):函数的关键字,便于搜索该函数。
Compact Node Title(标题): 函数的标题,用于显示在蓝图中的函数节点上。
Pure(纯函数): 勾选,则该函数变为纯函数。当仅需要该函数作为一个计算结果时,勾选该选项。
Call in Editor(编辑器调用): 勾选,则该函数可以在编辑器中调用。当需要在编辑器中调用该函数时,勾选该选项。
Access Specifier(访问修饰符): 函数的访问修饰符,用于控制函数的访问权限。
注意事项
- 函数的参数和返回值应当有明确的含义、类型、注释、命名,以便于理解和使用。
- 函数虽然可以嵌套调用,但是嵌套太深会导致代码难以理解,因此,建议将嵌套太深的函数拆分成多个函数。
- 不建议在函数中直接修改全局变量,因为这样会导致代码难以理解和维护。
- 不建议函数自身调用自身,这可能会导致无限调用。如果需要自身递归,一定要先写好跳出机制,防止无限调用