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.