Admin Production ni-theme
Current Publication

ListReplaceItem

LabWindows/CVI

ListReplaceItem

void ListReplaceItem (ListType list, const void *pointerToItem, ssize_t positionOfItemToReplace);

Purpose

This function copies the contents of the data item pointed to by pointerToItem over the contents of the item in the list at the specified position.

Parameters

Input
Name Type Description
list ListType The list whose specified item will be replaced.
pointerToItem const void * The pointer to the item which will replace the specified item in the list.
positionOfItemToReplace ssize_t The position of the item to replace. The position can be a number from 1 to the number of items in the list. Positions in the list are one-based.

To replace the first item in a list, pass -1 or the constant FRONT_OF_LIST.

To replace the last item in a list, pass 0 or the constant END_OF_LIST.

Return Value

None.

Additional Information

Library: Programmer's Toolbox

Include file: toolbox\toolbox.h

LabWindows/CVI compatibility: LabWindows/CVI 4.0 and later