NAME

       XmListGetMatchPos — A List function that returns all instances of an item in the list "XmListGetMatchPos"
       "List functions" "XmListGetMatchPos"

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(3)