ListInsertItems
int ListInsertItems (ListType list, const void *pointerToItems, ssize_t positionToInsertAt, ssize_t numberOfItemsToInsert);
Purpose
This function inserts copies of the specified items into the list.
Parameters
| Input | ||
| Name | Type | Description |
| list | ListType | The list to insert the items into. |
| pointerToItems | const void * | The pointer to the items to insert. |
| positionToInsertAt | ssize_t | The position at which to insert the items. The position can be a number from 1 to the number of items in the list. Positions in the list are one-based. To insert starting at the front of the list, pass -1 or the constant FRONT_OF_LIST. To insert starting at the end of the list, pass 0 or the constant END_OF_LIST. The items at or above the specified position are moved up to accommodate the new items. |
| numberOfItemsToInsert | ssize_t | Specifies the number of items to insert. |
Return Value
| Name | Type | Description |
| result | int | Returns non–zero if the items were inserted. Returns zero (0) if an error occurs. |
Additional Information
Library: Programmer's Toolbox
Include file: toolbox\toolbox.h
LabWindows/CVI compatibility: LabWindows/CVI 4.0 and later