Click this button to go to the index for this section.

XmListGetMatchPos(3X)
OSF/Motif


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

SYNOPSIS
  #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 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.

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

  position_count
      Returns the number of elements in the position_list.

  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.









SEE ALSO
  XmList(3X)