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.

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