TABLE OF CONTENTS:
- How to Write External Functions
All external functions are stored as JS objects in the variable "allScripts" found in the scripts.js file.
The easiest way to explain how to write external functions is by showing one:
var allScripts = {
"stdlib": { //not the actual standard lib, just 1 function from it
"obtain_poke" :
`fanfare 0x13E
msgbox You received a %ARG1! 0x4`
}
}Notice the %ARG1 at the end. When an external function is being evaluated, the number of arguments is determined by the highest %ARGX value found within the code, and when a function is called, any %ARGX references are replaced with the argument values (in other words, the parameters the function is called with get passed into the function), just like how functions in languages like Python or JS work.
You can also reference other external functions within an external function definition:
var allScripts = {
"stdlib" : {
"obtain_poke" :
`fanfare 0x13E
msgbox You received a %ARG1! 0x4`,
"name_poke" :
`msg Would you like to give a\\nnickname to %ARG1? 0x5
compare 0x800D 0x1
if 0x1 call %ARG2`,
"obtain_and_name" :
`fcall obtain-poke %ARG1
fcall name-poke %ARG1 %ARG2`
}
}