


XmTextFindString(3X)					 XmTextFindString(3X)
OSF/Motif							    OSF/Motif



NAME
  XXmmTTeexxttFFiinnddSSttrriinngg - A Text function that finds	the beginning position of a
  text string

SYNOPSIS


  ##iinncclluuddee <<XXmm//XXmm..hh>>
  BBoooolleeaann XXmmTTeexxttFFiinnddSSttrriinngg ((_w_i_d_g_e_t, _s_t_a_r_t, _s_t_r_i_n_g, _d_i_r_e_c_t_i_o_n,
	  _p_o_s_i_t_i_o_n))
       WWiiddggeett	   _w_i_d_g_e_t;;
       XXmmTTeexxttPPoossiittiioonn_s_t_a_r_t;;
       cchhaarr	   **_s_t_r_i_n_g;;
       XXmmTTeexxttDDiirreeccttiioonn_d_i_r_e_c_t_i_o_n;;
       XXmmTTeexxttPPoossiittiioonn**_p_o_s_i_t_i_o_n;;

DESCRIPTION
  XXmmTTeexxttFFiinnddSSttrriinngg locates the beginning position of a specified text string.
  This routine searches	forward	or backward for	the first occurrence of	the
  string starting from the given start position. If it finds a match, the
  function returns the position	of the first character of the string in	_p_o_s_i_-
  _t_i_o_n.

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

  _s_t_a_r_t	 Specifies the character position from which the search	proceeds.
	 This is an integer number of characters from the beginning of the
	 text buffer.  The first character position is 0.

  _s_t_r_i_n_g Specifies the search string.

  _d_i_r_e_c_t_i_o_n
	 Indicates the search direction.  It is	relative to the	primary
	 direction of the text.	 The possible values are

	 XXmmTTEEXXTT__FFOORRWWAARRDD	   The search proceeds toward the end of the text
			   buffer.

	 XXmmTTEEXXTT__BBAACCKKWWAARRDD   The search proceeds toward the beginning of the
			   text	buffer.

  _p_o_s_i_t_i_o_n
	 Specifies the pointer in which	the first character position of	the
	 string	match is returned.  This is an integer number of characters
	 from the beginning of the buffer.  The	first character	position is
	 0.  If	the function returns False, this value is undefined.

  For a	complete definition of Text and	its associated resources, see
  XXmmTTeexxtt((33XX)).



RETURN VALUE
  Returns True if a string match is found; otherwise, returns False.




RELATED	INFORMATION
  XXmmTTeexxtt((33XX)) and XXmmTTeexxttFFiinnddSSttrriinnggWWccss((33XX)).
































































