/** * @license * Visual Blocks Language * * Copyright 2016 Google Inc. * https://developers.google.com/blockly/ * * 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. var code = ''; if (Blockly.Lua.STATEMENT_PREFIX) { // Automatic prefix insertion is switched off for this block. Add manually. code += Blockly.Lua.injectId(Blockly.Lua.STATEMENT_PREFIX, block); } if (Blockly.Lua.STATEMENT_SUFFIX) { // Suffix needs to be added before the function call. code += Blockly.Lua.injectId(Blockly.Lua.STATEMENT_SUFFIX, block); } // 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); code += tuple[0] + '\n'; return code; }; 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; };