创建自定义块 - 缓存参数

---

title: 创建自定义块 - 缓存参数

Caching Arguments

当从块生成代码时，经常发现需要多次使用子块的返回值。考虑一个值块，它找到并返回一个列表的最后一个元素。块本身将有一个输入（一个列表），并且将返回一个值（最后一个元素）。这里是JavaScript的生成器：

var code = arg0 + '[' + arg0 + '.length - 1]';

如果arg0是一个变量名，这个生成器返回完全可以接受的JavaScript：

aList[aList.length - 1]

然而，如果arg0是一个函数调用，这个生成器可能有意想不到的行为。考虑下面的代码：

randomList()[randomList().length - 1]

两个返回的值可能具有不同的长度，导致超出范围条件。此外，如果函数调用有副作用，则调用它两次可能是不希望的。
这个问题有两个解决方案。语句块应使用临时变量。值块应使用效用函数。

临时变量

---

最简单的解决方案是将违规输入分配给临时变量。必须注意，此变量不会意外地与现有变量碰撞。下面的代码显示了语句块中临时变量的示例，它提示列表的最后一个元素。

var listVar = Blockly.JavaScript.variableDB_.getDistinctName(
    'temp_list', Blockly.Variables.NAME_TYPE);
var code = 'var ' + listVar + ' = ' + arg0 + ';\n';
code += 'alert(' + listVar + '[' + listVar + '.length - 1]);\n';

getDistinctName调用接受所需变量名（“temp_list”）的参数，并返回一个非冲突的名称（可能是“temp_list2”）。
临时变量的缺点是，如果违规输入已经是一个变量，那么会生成冗余代码：

var temp_list = foo;
alert(temp_list[temp_list.length - 1]);

要生成更干净的代码，请检查违规输入是否是一个简单的文字，并相应地生成代码：

if (arg0.match(/^\w+$/)) {
  var code = 'alert(' + arg0 + '[' + arg0 + '.length - 1]);\n';
} else {
  var listVar = Blockly.JavaScript.variableDB_.getDistinctName(
      'temp_list', Blockly.Variables.NAME_TYPE);
  var code = 'var ' + listVar + ' = ' + arg0 + ';\n';
  code += 'alert(' + listVar + '[' + listVar + '.length - 1]);\n';
}

有关临时变量的工作示例，请参见Blockly.JavaScript.controls_forEach。

临时变量在语句块（在这种情况下是警报）中工作良好，其中生成的代码可能跨越多行。然而，它们在值块中不可行，这些值块必须在单行上。对于值块，必须使用效用函数而不是临时变量。

Utility Functions(?效用函数)

---

定义效用函数是创建在比底层语言更高级别上操作的块的有效方式。除非使用效用函数，否则不会生成效用函数，并且它们只生成一次，而不考虑它们的使用次数。

var functionName = Blockly.JavaScript.provideFunction_(
    'list_lastElement',
    [ 'function ' + Blockly.JavaScript.FUNCTION_NAME_PLACEHOLDER_ + '(aList) {',
      '  // Return the last element of a list.',
      '  return aList[aList.length - 1];',
      '}']);
// Generate the function call for this block.
var code = functionName + '(' + arg0 + ')';
return [code, Blockly.JavaScript.ORDER_FUNCTION_CALL];

在上面的例子中，我们请求定义一个名为list_lastElement的实用函数（尽管实际名称可能不同，以避免与用户变量冲突）。有关效用函数的工作示例，请参见Blockly.JavaScript.text_endString。