# ListInsertItems

int ListInsertItems (ListType list, const void *pointerToItems, int positionToInsertAt, int 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 | 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.

## Return Value

Name | Type | Description
result | integer | Returns non–zero if the items were inserted. Returns zero (0) if an error occurs.