SysStemDelete

>>-SysStemDelete(stem,startitem-+--------------+-)-------------><
                                +-,--itemcount-+

Deletes the specified item at the index startitem in the stem. If more than one item is to be deleted the itemcount must be specified. After deleting the requested items the stem is compacted, which means that items following the deleted items are moved to the vacant positions.

This function operates only on stem arrays that specify the number of items in stem.0 and all items must be numbered from 1 to n without omitting an index.

Parameters:

stem

The name of the stem from which the item is to be deleted.

startitem

The index of the item to be deleted.

itemcount

The number of items to be deleted if more than one.

Return codes:

0

Deleting was successful.

-1

Deleting failed.

Example:

Call SysStemDelete "MyStem.", 5
Call SysStemDelete "MyStem.", 5, 4