XmListGetMatchPos(3X) — XmListGetMatchPos--A List function that returns all instances of an item in the list XmListGetMatchPosList functions
#include <Xm/List.h>
Boolean XmListGetMatchPos (widget, item, position_list, position_count)
Widget widget;
XmString item;
int **position_list;
int *position_count;
XmListGetMatchPos is a Boolean function that returns an array of positions where a specified item is found in a List.
| widget | Specifies the ID of the List widget. | |
| item | Specifies the item to search for. | |
| position_list | Returns an array of positions at which the item occurs in the List. The position of the first item in the list is 1; the position of the second item is 2; and so on. When the return value is TRUE, XmListGetMatchPos allocates memory for this array. The caller is responsible for freeing this memory. | |
| position_count | Returns the number of elements in the position_list. |
For a complete definition of List and its associated resources, see XmList(3X).
Returns TRUE if the specified item is present in the list, and FALSE if it is not.