CALL

Call function. If function not found - script will be stopped and error posted (unlike the GOSUB).
CALL is equal to GOSUB, except cases then pointed function not defined and not found.

Syntax

call <function> [count] ; Call the <function> for [count] times
call <function> <function> ... <function> [count] ; Call all functions in series [count] times
random call <function> <function> ... <function> [count] ; Call any functions [count] times

Parameters

function
  • Name of the function that defined by sub/func/psub instructions.

count
  • Decimal number from 2 to 100, tells how many times next command or block will be retried.

Example 0x00

sleeps 500   ; Set Sleeps = 500 ms
 
call FUNCTION1   ; Call FUNCTION1
 
CYCLE:       ; Define Label "CYCLE"
 
call FUNCTION2 3 ; Call FUNCTION2 for 3 times
call FUNCTION3   ; Call FUNCTION3
 
goto CYCLE    ; Infinite cycle
 
; =================================
sub FUNCTION1 ; Define FUNCTION1
  10
ret           ; End of function
 
sub FUNCTION2 ; Define FUNCTION2
  rol
ret           ; End of function
 
sub FUNCTION3 ; Define FUNCTION3
  ror 2
ret           ; End of function
exgosub.mr_g.gif
exgosub.mr_r.gifexgosub.mr_b.gifexgosub.mr_r.gif