Museum

Home

Lab Overview

Retrotechnology Articles

Online Manuals

⇒ XmLiGetMa(Xm) — OpenDesktop Software Development System 3.0.0

Media Vault

Software Library

Restoration Projects

Artifacts Sought


 XmListGetMatchPos(Xm)          6 January 1993          XmListGetMatchPos(Xm)


 Name

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

 Syntax


    #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 posi-
    tions 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 posi-
            tion 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(Xm).

 Return value

    Returns True if the specified item is present in the list, and False if
    it is not.

 See also

    XmList(Xm)


Typewritten Software • bear@typewritten.org • Edmonds, WA 98026