SysStemInsert

>>-SysStemInsert(stem,position,value)--------------------------><

Inserts a new item at position in the stem. All items in the stem following this position are shifted down by one position.

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 in which an item is to be inserted.

position

The index at which the new item is to be inserted.

value

The value of the new item.

Return codes:

0

Inserting was successful.

-1

Inserting failed.

Example:

Call SysStemInsert "MyStem.", 5, "New value for item 5"