load is used to load a value from a memory ADDRESS.

v := xLoad(a,d) loads a value of type x from the memory location given by displace(a,d), where d is a displacement in storage units. If a is NULLADDRESS or unaligned (see Section 3.9), if d is not a multiple of the size of the smallest MAINSAIL data type, or if displace(a,d) is undefined, then xLoad(a,d) is also undefined. The STRING form loads only a STRING descriptor; the characters of the STRING are not referenced.

Another form of cLoad, which loads a character from a CHARADR, is described in Section 32.28.

40.16.1. Sized Load PROCEDUREs

The sized load PROCEDURE $xxxLoadSized, where xxx is the base data type abbreviation, loads a value of the sized data type whose type is given by the extended type code type from displace(a,dspl). For example:

$iLoadSized(a,0,$integerSigned1Code)

loads 1 byte from a and sign-extends it to form an INTEGER result.

$lbLoadSized(a,0,$longBits2Code)

loads a 2-byte quantity from a and zero-extends it to form a LONG BITS result.

If the extended type code is not a sized type code corresponding to the base type, a value of the base type's size is loaded. For example, either of:

$boLoadSized(a,0,pointerCode)
$boLoadSized(a)

is equivalent to:

boLoad(a)