XmListGetMatchPos(3X) UNIX System V XmListGetMatchPos(3X)
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)
Widget widget;
XmString item;
int **position_list;
int *position_count;
VERSION
This page documents version 1.2 of the Motif library.
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.
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.
RELATED INFORMATION
XmList(3X).
Page 1 (printed 4/30/98)