Returns the signed 32-bit value at the specified memory
location as an INTEGER value.
Syntax
GET-LONG ( source , position )
|
-
source
- A function or variable that returns a RAW or MEMPTR value. If source is
the Unknown value (?), GET-LONG returns the Unknown value (?).
-
position
- An integer value greater than 0 that indicates the byte position
where you want to find the information. If position is greater
than the length of source, the AVM returns the Unknown value (?).
If position is less than 1, the AVM generates
a run-time error.
Examples
For
examples of how to use the GET-LONG function, see the GET-BYTE function reference
entry.
Notes
- This
function supports byte-swapping only if source is
a MEMPTR data type. The function will first examine the byte-order
setting of the MEMPTR and then swap the bytes appropriately before
interpreting them. The AVM does not swap the bytes in the MEMPTR's
memory, but does the byte-swap as it creates the return value.
- For more information on using the MEMPTR and RAW data types, see OpenEdge
Development: Programming Interfaces.