VECTOR_INSERT

Syntax

int_val = VECTOR_INSERT ( vector_handle, location, new_element );
Input arguments:
handle vector_handle Vector.
int location Location for the new element.
untyped new_element New element to insert to the given location. Type can be int, float, string, or handle.

Return Values

Success:
int 0 Vector inserted successfully.
Failure:
int -1 Error.

Description

This function inserts a new element to the given location in a vector. The new element is added before the element that currently exists at the specified location. Vector size is increased by one.