INSERT
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: