Stores the signed 64-bit value of an INT64
or INTEGER expression at the specified memory location as an INT64
data type.
Syntax
PUT-INT64 ( destination , position ) = expression
|
-
destination
- A variable of type RAW or MEMPTR. If destination is
the Unknown value (?), it remains the Unknown value (?).
If destination is a MEMPTR and its region in
not allocated (by a SET-SIZE statement or by a Windows dynamic link
library (DLL) or UNIX shared library routine), the AVM generates
a run-time error.
-
position
- An integer value greater than 0 that indicates the byte position where the AVM stores
expression. If position is less than 1, the AVM
generates a run-time error.
For a RAW destination, if
position is greater than the length of
destination, the AVM increases the length of
destination to position plus the remaining
bytes needed to store expression. The gap between the original
destination length and position is padded with
null bytes.
For a MEMPTR destination, if
position is greater than the length of
destination or does not leave sufficient room to store
expression, the AVM generates a run-time error.
-
expression
- The integer value of a constant, field, variable, function,
or expression.
Example
See
the example in the GET-INT64 function section.