EXTERNAL INTEGRATION: DECLARE EXTERNAL FUNCTIONS (WITH PARAMETERS)

This small example explains how to declare external functions to be called as normal functions inside ugBASIC. Moreover, it explain the syntax on parameter definition and target limitation. Note that this code will not work since there is no assembly code at that position.

source compile sandbox issues? back to examples

SOURCE CODE ()

DECLARE FUNCTION seriale AT $c000 ( valore AS BYTE ON STACK(BYTE) ) RETURN STACK(BYTE) AS BYTE ON CPU6502

	CLS
	
	seriale[42] ON CPU6502
	
	PRINT PARAM(seriale ON CPU6502)

How to compile and run the example

The instructions here refer to compiling the example from the command line. For Microsoft Windows users we suggest using UGBASIC-IDE, which allows you to download and compile each single example with just one click.

Are instructions for your specific home computer / console missing? First of all, check if your computer is supported by clicking here. If so, since ugBASIC is a language which does not provide abstractions, it is possible that this example will not work on your target. If you think this is an issue, please click here.

Atari 1200XL, Atari 130XE, Atari 600XL, Atari 65XE, Atari 800XE, Atari 800XL, Atari XEGS

In order to compile the example, type this command on the command line:

Linux

ugbc.atarixl -O xex -o extern_example_13.xex extern_example_13.bas

Windows

ugbc.atarixl.exe -O xex -o extern_example_13.xex extern_example_13.bas

For Microsoft Windows users we suggest using UGBASIC-IDE, which allows you to download and compile this example with just one click.

Atari 400, Atari 800

In order to compile the example, type this command on the command line:

Linux

ugbc.atari -O xex -o extern_example_13.xex extern_example_13.bas

Windows

ugbc.atari.exe -O xex -o extern_example_13.xex extern_example_13.bas

For Microsoft Windows users we suggest using UGBASIC-IDE, which allows you to download and compile this example with just one click.

Commodore 128 (CPU 8502)

In order to compile the example, type this command on the command line:

Linux

ugbc.c128 -O prg -o extern_example_13.prg extern_example_13.bas

Windows

ugbc.c128.exe -O prg -o extern_example_13.prg extern_example_13.bas

For Microsoft Windows users we suggest using UGBASIC-IDE, which allows you to download and compile this example with just one click.

Commodore 64, Commodore Executive 64

In order to compile the example, type this command on the command line:

Linux

ugbc.c64 -O prg -o extern_example_13.prg extern_example_13.bas

Windows

ugbc.c64.exe -O prg -o extern_example_13.prg extern_example_13.bas

For Microsoft Windows users we suggest using UGBASIC-IDE, which allows you to download and compile this example with just one click.

Any problem?

If you have found a problem trying to run this example, if you think there is a bug or, more simply, you would like it to be improved, open an issue for this example on GitHub.
Thank you!

open an issue BACK TO EXAMPLES