CALL
====

Function
--------

**CALL** allows a machine code subroutine or an existing routine in
HUNTER's housekeeping package to be called from Basic and executed.

Syntax
------

D=CALL(N)

| where D is a variable
| N is a Call Address

Examples
--------

::

   10 A=CALL(0)
   20 B=CALL(V)

where V is the address to be called

Switches execution to the program located at the location specified. The
call in line 10 causes a restart of the HUNTER'S software.

Remarks
-------

.. Warning::

   Use CALL only as indicated in
   :doc:`../basic-programming/machine-code-calls`. Use of
   unspecified calls will crash HUNTER, resulting in loss of data, etc.

When control has passed back to Basic from a machine code program, then
D = the final number stored in the Z80 accumulator when the program
returns.