1XmListGetMatchPos(library call)                XmListGetMatchPos(library call)
2
3
4

NAME

6       XmListGetMatchPos  —  A  List function that returns all instances of an
7       item in the list
8

SYNOPSIS

10       #include <Xm/List.h>
11       Boolean XmListGetMatchPos(
12       Widget widget,
13       XmString item,
14       int **position_list,
15       int *position_count);
16

DESCRIPTION

18       XmListGetMatchPos is a Boolean function that returns an array of  posi‐
19       tions where a specified item is found in a List.
20
21       widget    Specifies the ID of the List widget.
22
23       item      Specifies the item to search for.
24
25       position_list
26                 Returns an array of positions at which the item occurs in the
27                 List.  The position of the first item in the list is  1;  the
28                 position of the second item is 2; and so on.  When the return
29                 value is True, XmListGetMatchPos allocates  memory  for  this
30                 array.   The  caller  is responsible for freeing this memory.
31                 The caller  can  recover  the  allocated  memory  by  calling
32                 XtFree.
33
34       position_count
35                 Returns the number of elements in the position_list.
36
37       For  a  complete  definition  of List and its associated resources, see
38       XmList(3).
39

RETURN

41       Returns True if the specified item is present in the list, and False if
42       it is not.
43
45       XmList(3).
46
47
48
49                                               XmListGetMatchPos(library call)
Impressum