


XmListGetMatchPos(3X)					XmListGetMatchPos(3X)
OSF/Motif							    OSF/Motif



NAME
  XXmmLLiissttGGeettMMaattcchhPPooss - A	List function that returns all instances of an item
  in the list

SYNOPSIS


  ##iinncclluuddee <<XXmm//LLiisstt..hh>>
  BBoooolleeaann XXmmLLiissttGGeettMMaattcchhPPooss ((_w_i_d_g_e_t, _i_t_e_m, _p_o_s_i_t_i_o_n__l_i_s_t,
	  _p_o_s_i_t_i_o_n__c_o_u_n_t))
       WWiiddggeett	 _w_i_d_g_e_t;;
       XXmmSSttrriinngg	 _i_t_e_m;;
       iinntt	 ****_p_o_s_i_t_i_o_n__l_i_s_t;;
       iinntt	 **_p_o_s_i_t_i_o_n__c_o_u_n_t;;

DESCRIPTION
  XXmmLLiissttGGeettMMaattcchhPPooss is a Boolean function that returns an array	of positions
  where	a specified item is found in a List.

  _w_i_d_g_e_t Specifies the ID of the List widget.

  _i_t_e_m	 Specifies the item to search for.

  _p_o_s_i_t_i_o_n__l_i_s_t
	 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, XXmmLLiisstt--
	 GGeettMMaattcchhPPooss allocates memory for this array.  The caller is respon-
	 sible for freeing this	memory.

  _p_o_s_i_t_i_o_n__c_o_u_n_t
	 Returns the number of elements	in the _p_o_s_i_t_i_o_n__l_i_s_t.

  For a	complete definition of List and	its associated resources, see
  XXmmLLiisstt((33XX)).

RETURN VALUE
  Returns TRUE if the specified	item is	present	in the list, and FALSE if it
  is not.

RELATED	INFORMATION
  XXmmLLiisstt((33XX)).
















