int ListInsertItems (ListType list, const void *pointerToItems, int positionToInsertAt, int numberOfItemsToInsert);
This function inserts copies of the specified items into the list.
Input | ||
Name | Type | Description |
list | ListType | The list to insert the items into. |
pointerToItems | const void * | The pointer to the items to insert. |
positionToInsertAt | integer | The position at which to insert the items. The position may be a number from 1 to the number of items in the list. To insert starting at the front of the list, the constant FRONT_OF_LIST may be passed. To insert starting at the end of the list, the constant END_OF_LIST may be passed. The items at or above the specified position are moved up to accomodate the new items. |
numberOfItemsToInsert | integer | Specifies the number of items to insert. |
Name | Type | Description |
result | integer | Returns non–zero if the items were inserted. Returns zero (0) if an error occurs. |