AADD([vektorimuuttuja],[arvo],[numero])

Parametrit

[vektorimuuttuja] on vektorimuuttuja, johon halutaan lisätä uusi elementti. [arvo] on em. uusi elementti.
[numero] on aiemman aadd():n palauttama arvo (kt. esimerkki).

Palautusarvo

Mikäli [numero] annetaan AADD() palauttaa viimeisimmän lisätyn objektin osoiteen (kt esimerkki).

Selitys

AADD()-funktiolla voidaan lisätä olemassa olevaan vektorimuuttujaan lisää elementtejä.

Esimerkki

apu={} /* apu on nyt vektorimuuttuja, jossa ei ole yhtään elementtiä */
AADD(apu,10)
/* apu on nyt {10} */
AADD(apu,5)
/* apu on nyt {10,5} */
AADD(apu,{"Hei","Nyt"})
/* apu on nyt {10,5,{"Hei","Nyt"}} */

Mikäli käytetään suuria määriä vektoriobjekteja funktion toimintaa voidaan nopeuttaa. Normaalisti aadd() aloittaa vektorin alusta ja etsii käsille viimeisimmän objektin ja lisää sitten sen jatkoksi uuden objektin. Tämä vie kauan, jos vektorissa on ennestään tuhansia nimikkeitä.
Jos toimitaan seuraavasti eli annetaan kolmantena parametrinä viimeisimmän lisätä osoite funktio lisää tämän perään uuden objektin suoraan (huom! aluksi annetaan nolla):

apu={} /* apu on nyt vektorimuuttuja, jossa ei ole yhtään elementtiä */
viim=0
i=1
do while i<=100000
   viim=AADD(apu,10,viim)
   i=i+1
enddo
/* apu on nyt 100,000 objektia sisältävä vektori */

Katso myös AFILL()