ALPHA-VISION® Database Operations: GetRecord

GetRecord

SUMMARY

GetRecord - reads records from tables pushed onto the stack.

SYNTAX

GetRecord(<recordnr>);

ARGUMENTS

recordnr (type:integer)

The record number (the first record got number 0).

DESCRIPTION

1. Missing arguments are taken from the stack.(and removed from there).
2. The table must be on the stack also.
3. The result is pushed on top of the stack.

The ExecSql-Job pushes its result (table - e.g. on SELECT) onto the stack. 'GetRecord' reads single records from that table.

EXAMPLES

//Stack before (2 Elements: Index and a Tabelle with 2 Records of 2 Fields each):
//0
//{
//  {
//    {"PROD_ID", "ABC1"},
//    {"DESCR", "Product ABC, Version 1"}
//  },
//  {
//    {"PROD_ID", "XYZ2"},
//    {"DESCR", "Product XYZ, Version 2"}
//  }
//}
GetRecord();
//Stack afterwards: 2 Elements:
//{
//  {"PROD_ID", "ABC1"},
//  {"DESCR", "Product ABC, Version 1"}
//}
//{
//  {
//    {"PROD_ID", "ABC1"},
//    {"DESCR", "Product ABC, Version 1"}
//  },
//  {
//    {"PROD_ID", "XYZ2"},
//    {"DESCR", "Product XYZ, Version 2"}
//  }
//}

---

Syntax Notation

[aaa]

aaa is optional (zero or one occurences)

(aaa|bbb)

aaa exclusive or bbb

(aaa)*

aaa may occur indefinitely often or may be omitted

(aaa)+

aaa may occur indefinitely often but at least once

(aaa)m..n

aaa may occur from m to n times