XmListGetMatchPos(library call) XmListGetMatchPos(library call)

NAME

XmListGetMatchPos -- A List function that returns all instances of an
item in the list

SYNOPSIS

#include <Xm/List.h>
Boolean XmListGetMatchPos(
Widget widget,
XmString item,
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.

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. The caller can recover the allocated memory by
calling XtFree.

position_count
Returns the number of elements in the position_list.

For a complete definition of List and its associated resources, see
XmList(3).

RETURN

Returns True if the specified item is present in the list, and False
if it is not.

RELATED

XmList(3).

XmListGetMatchPos(library call)