mirror of
https://github.com/google/blockly.git
synced 2026-01-05 08:00:09 +01:00
b46a4fe286
* Google changed from an Inc to an LLC. This happened back in 2017 but we didn’t notice. Officially we should update files from Inc to LLC when they are changed as part of regular edits, but this is a nightmare to remember for the next decade. * Remove project description/titles from licenses This is no longer part of Google’s header requirements. Our existing descriptions were useless (“Visual Blocks Editor”) or grossly obselete (“Visual Blocks Language”). * License no longer requires URL. * Fix license regexps.
123 lines
4.3 KiB
JavaScript
123 lines
4.3 KiB
JavaScript
/**
|
|
* @license
|
|
* Copyright 2016 Google LLC
|
|
*
|
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
|
* you may not use this file except in compliance with the License.
|
|
* You may obtain a copy of the License at
|
|
*
|
|
* http://www.apache.org/licenses/LICENSE-2.0
|
|
*
|
|
* Unless required by applicable law or agreed to in writing, software
|
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
* See the License for the specific language governing permissions and
|
|
* limitations under the License.
|
|
*/
|
|
|
|
/**
|
|
* @fileoverview Generating Lua for procedure blocks.
|
|
* @author rodrigoq@google.com (Rodrigo Queiro)
|
|
*/
|
|
'use strict';
|
|
|
|
goog.provide('Blockly.Lua.procedures');
|
|
|
|
goog.require('Blockly.Lua');
|
|
|
|
|
|
Blockly.Lua['procedures_defreturn'] = function(block) {
|
|
// Define a procedure with a return value.
|
|
var funcName = Blockly.Lua.variableDB_.getName(
|
|
block.getFieldValue('NAME'), Blockly.Procedures.NAME_TYPE);
|
|
var xfix1 = '';
|
|
if (Blockly.Lua.STATEMENT_PREFIX) {
|
|
xfix1 += Blockly.Lua.injectId(Blockly.Lua.STATEMENT_PREFIX, block);
|
|
}
|
|
if (Blockly.Lua.STATEMENT_SUFFIX) {
|
|
xfix1 += Blockly.Lua.injectId(Blockly.Lua.STATEMENT_SUFFIX, block);
|
|
}
|
|
if (xfix1) {
|
|
xfix1 = Blockly.Lua.prefixLines(xfix1, Blockly.Lua.INDENT);
|
|
}
|
|
var loopTrap = '';
|
|
if (Blockly.Lua.INFINITE_LOOP_TRAP) {
|
|
loopTrap = Blockly.Lua.prefixLines(
|
|
Blockly.Lua.injectId(Blockly.Lua.INFINITE_LOOP_TRAP, block),
|
|
Blockly.Lua.INDENT);
|
|
}
|
|
var branch = Blockly.Lua.statementToCode(block, 'STACK');
|
|
var returnValue = Blockly.Lua.valueToCode(block, 'RETURN',
|
|
Blockly.Lua.ORDER_NONE) || '';
|
|
var xfix2 = '';
|
|
if (branch && returnValue) {
|
|
// After executing the function body, revisit this block for the return.
|
|
xfix2 = xfix1;
|
|
}
|
|
if (returnValue) {
|
|
returnValue = Blockly.Lua.INDENT + 'return ' + returnValue + '\n';
|
|
} else if (!branch) {
|
|
branch = '';
|
|
}
|
|
var args = [];
|
|
for (var i = 0; i < block.arguments_.length; i++) {
|
|
args[i] = Blockly.Lua.variableDB_.getName(block.arguments_[i],
|
|
Blockly.Variables.NAME_TYPE);
|
|
}
|
|
var code = 'function ' + funcName + '(' + args.join(', ') + ')\n' +
|
|
xfix1 + loopTrap + branch + xfix2 + returnValue + 'end\n';
|
|
code = Blockly.Lua.scrub_(block, code);
|
|
// Add % so as not to collide with helper functions in definitions list.
|
|
Blockly.Lua.definitions_['%' + funcName] = code;
|
|
return null;
|
|
};
|
|
|
|
// Defining a procedure without a return value uses the same generator as
|
|
// a procedure with a return value.
|
|
Blockly.Lua['procedures_defnoreturn'] =
|
|
Blockly.Lua['procedures_defreturn'];
|
|
|
|
Blockly.Lua['procedures_callreturn'] = function(block) {
|
|
// Call a procedure with a return value.
|
|
var funcName = Blockly.Lua.variableDB_.getName(
|
|
block.getFieldValue('NAME'), Blockly.Procedures.NAME_TYPE);
|
|
var args = [];
|
|
for (var i = 0; i < block.arguments_.length; i++) {
|
|
args[i] = Blockly.Lua.valueToCode(block, 'ARG' + i,
|
|
Blockly.Lua.ORDER_NONE) || 'nil';
|
|
}
|
|
var code = funcName + '(' + args.join(', ') + ')';
|
|
return [code, Blockly.Lua.ORDER_HIGH];
|
|
};
|
|
|
|
Blockly.Lua['procedures_callnoreturn'] = function(block) {
|
|
// Call a procedure with no return value.
|
|
// Generated code is for a function call as a statement is the same as a
|
|
// function call as a value, with the addition of line ending.
|
|
var tuple = Blockly.Lua['procedures_callreturn'](block);
|
|
return tuple[0] + '\n';
|
|
};
|
|
|
|
Blockly.Lua['procedures_ifreturn'] = function(block) {
|
|
// Conditionally return value from a procedure.
|
|
var condition = Blockly.Lua.valueToCode(block, 'CONDITION',
|
|
Blockly.Lua.ORDER_NONE) || 'false';
|
|
var code = 'if ' + condition + ' then\n';
|
|
if (Blockly.Lua.STATEMENT_SUFFIX) {
|
|
// Inject any statement suffix here since the regular one at the end
|
|
// will not get executed if the return is triggered.
|
|
code += Blockly.Lua.prefixLines(
|
|
Blockly.Lua.injectId(Blockly.Lua.STATEMENT_SUFFIX, block),
|
|
Blockly.Lua.INDENT);
|
|
}
|
|
if (block.hasReturnValue_) {
|
|
var value = Blockly.Lua.valueToCode(block, 'VALUE',
|
|
Blockly.Lua.ORDER_NONE) || 'nil';
|
|
code += Blockly.Lua.INDENT + 'return ' + value + '\n';
|
|
} else {
|
|
code += Blockly.Lua.INDENT + 'return\n';
|
|
}
|
|
code += 'end\n';
|
|
return code;
|
|
};
|