ListSetAllocationPolicy
void ListSetAllocationPolicy (ListType list, int minNumItemsPerExpansion, int percentIncreasePerExpansion);
Purpose
This function configures how much new space a list will allocate for new items when it becomes full.
The space reserved for the list is increased by whichever is greatest: the number of items calculated from the specified percentage, or the value of minNumItemsPerExpansion.
The default allocation policy works well in almost any situation, therefore it is unlikely that you will want to call this function.
Parameters
| Input | ||
| Name | Type | Description |
| list | ListType | The list to set the allocation policy for. |
| minNumItemsPerExpansion | int | Pass the minimum number of items the list should allocate space for when the list if full and needs more space. |
| percentIncreasePerExpansion | int | Pass the percentage of the number of its items the list should allocate space for when the list if full and needs more space. For example if the percentage is set to 10 for a list with 200 items, then space for 20 new items will be allocated when the list needs more memory. |
Return Value
None.
Additional Information
Library: Programmer's Toolbox
Include file: toolbox\toolbox.h
LabWindows/CVI compatibility: LabWindows/CVI 4.0 and later