blockly > CodeGenerator > provideFunction_

CodeGenerator.provideFunction_() 方法

定义要包含在生成的代码中的开发者定义的函数(而非用户定义的过程)。用于创建私有辅助函数。第一次使用指定的 requiredName 调用此方法时,系统会保存代码并生成实际名称。具有相同 requiredName 的后续调用不会有任何作用,但具有相同的返回值。

调用方应确保不同的辅助函数中未使用相同的 requiredName(例如,使用“colourRandom”和“listRandom”,而非“random”)。不存在与保留字、用户定义的变量或过程名称冲突的风险。

调用 CodeGenerator.finish() 时,系统会输出该代码。

Signature:

provideFunction_(desiredName: string, code: string[] | string): string;

参数

参数 类型 说明
desiredName string 所需的函数名称(例如 MathIsPrime)。
验证码 string[] | 字符串 语句列表或一个多行代码字符串。使用“ ”进行缩进(它们将被替换)。

返回

string

新函数的实际名称。如果前者已被用户占用,则此值可能与 missingName 不同。