1XmListGetMatchPos(library call) XmListGetMatchPos(library call)
2
3
4
6 XmListGetMatchPos — A List function that returns all instances of an
7 item in the list
8
10 #include <Xm/List.h>
11 Boolean XmListGetMatchPos(
12 Widget widget,
13 XmString item,
14 int **position_list,
15 int *position_count);
16
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
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)