Essentially, a complete executable example of a simple ASM.js program that involves a foreign function, including processing return values. (I imagine if it's this simple, then return values are handled using the same annotations as ASM.js functions?)
While I understand that specs don't necessarily have to have examples, I believe it would benefit the community to have one in the ASM.js spec.
Thanks for clarifying here, though! I now understand.
edit: btw, there is a full example here https://github.com/dherman/asm.js/#example
I would definitely lobby to get something smaller and concise into the spec under the "Putting it All Together" heading! You could modify the existing example in the spec to include an external function definition and call.
How does it deduce the return type of a foreign function? Can foreign functions return values?
Normally, ASM.js functions require an annotation on the return statement [0].
i = ffiFunc() | 0; // returns an int
d = +ffiFunc(); // returns a double
This is identical for FFI and non-FFI calls. A difference though is that asm functions have specific types (an asm function returns either nothing, an int, or a double). But an FFI is just any old JS function. So you could not write the above 2 lines together with an asm function, only an FFI can get an int one time and a double another time from the same function.btw, I hope these questions make it clearer why I grumped a bit about the specification, and result in a more robust spec!