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, XmList-
            GetMatchPos allocates memory for this array.  The caller is  respon-
            sible 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 Xm-
     List(3X).

RETURN VALUE
     Returns TRUE if the specified item is present in the list, and FALSE if  it
     is not.

RELATED INFORMATION
     XmList(3X).

                                                           XmListGetMatchPos(3X)