Clearing

Added June 2013

.CLEAR $aryname()

The "dot-clear" statement removes all the elements of the array, without destroying the array itself.   

Dimx $capitals,ordmap(varstr;varstr)   ! declare array

Print .extent($capitals())             ! initial extent is 0

$capitals(“california”) = “sacramento” ! add an element

$capitals(“nevada”) = “carson city”    ! add another element

Print .extent($capitals())             ! extent is now 2

.clear $capitals()                     ! clear all elements

Print .extent($capitals())             ! extent is now 0

 

Note: Requires compiler version 638 or higher to compile this statement, and A-Shell version 6.1.1354 or higher to execute it, otherwise you'll get an illegal syntax code error.