6 — Fetch contents of array
function, segment name, error status, array name, array
length
This function retrieves the named segment and stores the
contents in the named real, integer, or string array Integer Basic
only). The array must be specified by name. If the array length
value is specified, it must be a variable name. If it is
specified, RAMEXPAND will return the number of bytes actually
stored in the array in this variable. This can be used to deter-
mine how much data was returned. The number must be divided by
the size of an array element to determine how many elements it
represents. For integers, the size is 2 bytes. For reals, the
size is 6 bytes. For fetching Applesoft string arrays, use
function #16.
Error status:
0 = success
1 illegal function
2 = variable not found
8 = segment not found
9 = illegal segment name
11 = no array specified
7 — Exchange array
function, segment name, error status, array name, array
length
This function exchanges the contents of an array in normal
RAM with the contents of an array in extended RAM. Other than
the exchange, this function acts just like the Fetch Array
function. The array must be specified by name. If the array
length value is specified, it must be a variable name. If if is
specified, RAMEXPAND will return the actual number of bytes
stored in the array in this variable. This can be used to
determine how much data was returned. This number should be
divided by the number of bytes per array element to determine how
many elements it represents. For integers, the size is 2 bytes.
For reals, the size is 6 bytes.
Error status:
0 = success
1 = illegal function
2 = variable not found
8 = segment not found
9 = illegal segment name
11 = no array specified
41
Kommentare zu diesen Handbüchern