...\" **  (c) Copyright 1993, 1994 Hewlett-Packard Company
...\" **  (c) Copyright 1993, 1994 International Business Machines Corp.
...\" **  (c) Copyright 1993, 1994 Sun Microsystems, Inc.
...\" **  (c) Copyright 1993, 1994 Novell, Inc
...\" **
...\" **
...\" **
...\" **  (c) Copyright 1989, 1990, 1992 by Open Software Foundation, Inc.
...\" **      All Rights Reserved.
...\" **
...\" **  (c) Copyright 1987, 1988, 1989, by Hewlett-Packard Company
...\" **
...\" **
.TH XmListGetMatchPos 3X "" "" "" ""
.ds )H Hewlett-Packard Company
.ds ]W Motif Release 1.2: May 1992
.SH NAME
\fIXmListGetMatchPos\fP \- A List function that returns all instances of an item in the list
.SH SYNOPSIS
.nf
.sS
.iS
\&#include <Xm/List.h>
.sp \n(PDu
Boolean XmListGetMatchPos (\fBwidget, item, position_list, position_count\fI)
.ta .5i 1.5i
.nf
	Widget	\fBwidget\fI;
	XmString	\fBitem\fI;
	int	**\fBposition_list\fI;
	int	*\fBposition_count\fI;
.wH
.fi
.iE
.sE
.SH DESCRIPTION
.fi
\fIXmListGetMatchPos\fP is a Boolean function that returns an array of
positions where a specified item is found in a List.
.nL
.ne 5
.IP "\fBwidget\fP"
Specifies the ID of the List widget.
.IP "\fBitem\fP"
Specifies the item to search for.
.IP "\fBposition_list\fP"
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, \fIXmListGetMatchPos\fP allocates
memory for this array.
The caller is responsible for freeing this memory.
.IP "\fBposition_count\fP"
Returns the number of elements in the \fBposition_list\fP.
.PP 
For a complete definition of List and its associated resources, see
\fIXmList(3X)\fP.
.SH RETURN VALUE
Returns TRUE if the specified item is present in the list, and
FALSE if it is not.
.SH RELATED INFORMATION
.na
\fIXmList(3X)\fP.
.ad