XmListGetMatchPos(3X)
Prev | Reference Pages | Next

## Name

XmListGetMatchPos(3X) — XmListGetMatchPos--A List function that returns all instances of an item in the list XmListGetMatchPosList functions

## Synopsis

#include <Xm/List.h>
Boolean XmListGetMatchPos (`widget, item, position_list, position_count`)
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.
`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).

Prev | Table of Contents | Next
XmListGetKbdItemPos(3X) |  | XmListGetSelectedPos(3X)