GetLong Function

Action

Retrieves a long value (4-byte signed integer value) from a specified data structure at a specified position. You must declare a BDL string before using this function.

Include file

Kernel.bdh

Syntax

GetLong(in sString : string,
in nPos : number,
in nByteOrder : number optional): number;

Return value

number

Parameter Description
sString BDL string corresponding to the data structure
nPos Starting position in the BDL string, where the first position is 1 (not 0)
nByteOrer

Specifies the byte order that is applied when a value is retrieved (optional). This parameter can be one of the following:

  • OPT_LITTLE_ENDIAN. Microsoft byte order (default).

  • OPT_BIG_ENDIAN. Network, Apple, Java byte order.

Example

dcltrans
transaction TGetLong
constSIZE_STRUCT := 32;
var
myBDLstring : string(SIZE_STRUCT);
nLong : number;
begin...// Retrieve a 4-byte signed integer value from position 4
// in the BDL string myBDLstring and thereby (through mapping) get
// the element myLong in Struct1
nLong := GetLong(myBDLstring, 4);
write("myLong = "); write(nLong); writeln;
end TGetLong;

Output

myLong = 497202