Akcia INSERT

Funkcia
Akcia vloží jeden alebo viac riadkov do štruktúry.
Deklarácia
?
INSERT _struct, beforeIdx, rowsToInsert[, lastRow]

Parametre
struct in/out Identifikátor celej štruktúry, do ktorej sa bude vkladať.
beforeIdx in Identifikátor typu Int - riadok, pred ktorý sa bude vkladať.
rowsToInsert in Identifikátor celej štruktúry alebo identifikátor jedného riadku štruktúry - vkladané riadky/riadok.
lastRow in Nepovinný parameter - identifikátor jedného riadku štruktúry.

Popis
Akcia vloží:
  • riadok - parameter rowsToInsert je odkaz na riadok štruktúry
  • riadky (celú štruktúru) - parameter rowsToInsert je odkaz na celú štruktúru
Vkladanie bude vykonané do lokálnej štruktúry _struct pred riadok definovaný parametrom _beforeIdx. Ak _beforeIdx = _struct\DIM+1 alebo _beforeIdx = -1, akcia vkladaný riadok (riadky) pripojí na koniec štruktúry (APPEND). Pri inej hodnote parametra _beforeIdx akcia generuje chybu _ERR_RANGE_ERROR. Štruktúry _struct a rowsToInsert musia byť rovnakého typu.

Ak je použitý parameter lastRow, akcia zo zdrojovej štruktúry kopíruje riadky ohraničené parametrami rowsToInsert a lastRow. V takomto prípade je potrebné, aby oba parametre predstavovali riadok rovnakej štruktúry.


Príklad
?
RECORD (SD.RecordDef) _struct
RECORD (SD.RecordDef) _rowsToInsert
INT _beforeIdx
 
REDIM _struct[10]
REDIM _rowsToInsert[2]
 
; vlozenie 1. riadku na zaciatok
INSERT _struct, 1, _rowsToInsert[1]
 
; vlozenie 2. riadku na koniec
_beforeIdx := _struct\DIM+1
INSERT _struct, _beforeIdx, _rowsToInsert[2]
 
; vlozenie celej struktury _rowsToInsert na zaciatok
INSERT _struct, 1 , _rowsToInsert

Príklad 2
Vloženie 1. a 2. riadku zo štruktúry _rowsToInsert na začiatok štruktúry _struct.
 
?
INSERT _struct, 1, _rowsToInsert[1], _rowsToInsert[2]

Súvisiace stránky:

Akcie v skriptoch

Napíšte komentár