NAME    [Toc]    [Back]

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

SYNOPSIS    [Toc]    [Back]

       #include <Xm/List.h>

       Boolean XmListGetMatchPos  (widget,  item,  position_list,
       position_count)
               Widget widget;
               XmString item;
               int **position_list;
               int *position_count;

DESCRIPTION    [Toc]    [Back]

       XmListGetMatchPos  is  a  Boolean function that returns an
       array of positions where a specified item is  found  in  a
       List.  Specifies the ID of the List widget.  Specifies the
       item to search for.  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.  Returns
       the number of elements in the position_list.

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

RETURN VALUE    [Toc]    [Back]

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

SEE ALSO    [Toc]    [Back]

       XmList(3X)



                                            XmListGetMatchPos(3X)