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. |