XmListGetMatchPos(3X) — Subroutines
OSF
NAME
XmListGetMatchPos — a List function that returns all instances of an item in the list.
SYNOPSIS
#include <Xm/List.h> Boolean XmListGetMatchPos (widget, item, position_list, position_count)
Widgetwidget;
XmStringitem;
int∗∗position_list;
int∗position_count;
DESCRIPTION
XmListGetMatchPos is a Boolean function that returns an array of positions where a specified item is found in a List.
widgetSpecifies the ID of the List widget.
itemSpecifies 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).
RETURN VALUE
Returns TRUE if the specified item is present in the list, and FALSE if it is not.