# ListRemoveItems

void ListRemoveItems (ListType list, void *itemsDestination, int firstItemToRemove, int numberOfItemsToRemove);

## Purpose

This function removes a specified number of consecutive items from a list. If itemsDestination is not zero (0) then the contents of the items will be copied to itemsDestination after the items are removed.

## Parameters

Input
Name | Type | Description
list | ListType | The list whose specified items will be removed.
itemsDestination | void * | A pointer to where the contents of the specified items will be copied after they are deleted from the list. Zero (0) may be passed if the items are to be deleted from the list without being copied to another location.
firstItemToRemove | integer | The position of the first item to remove. The position may be a number from 1 to the number of items in the list. To remove items starting at the first item in a list, the constant FRONT_OF_LIST may be passed. To remove the last item in a list, the constant END_OF_LIST may be passed.
numberOfItemsToRemove | integer | Specifies the number of items to remove from the list.

## Return Value

None.