47.49. store

store is used to store a value into a memory or character address.

The forms in which an ADDRESS is the first parameter store the value v into the memory location given by displace(a,dspl). If a is NULLADDRESS or unaligned (see Section 3.9), if dspl is not a multiple of the size of the smallest MAINSAIL data type, or if displace(a,dspl) is undefined, the effect of store is undefined. The form in which a CHARADR is the first argument stores the character code v at the character address given by displace(c,dspl). If c is NULLCHARADR or displace(c,dspl) is undefined, the effect of store is undefined.

Even if v is an explicitly sized value (see Section 3.12), store always stores a value of the size of v's base type. Use $storeSized (see Section 47.52) to control the number of bytes stored for a given value.