XmListGetMatchPos(3X) — DG/UX R4.11MU05



XmListGetMatchPos(3X)         SDK X11 R4.11MU05        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, positionlist, positioncount)
            Widget    widget;
            XmString  item;
            int       **positionlist;
            int       *positioncount;


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.

        positionlist
               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.

        positioncount
               Returns the number of elements in the positionlist.


       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).


Licensed material--property of copyright holder(s)
Museum
