


XmTextFindStringWcs(3X)				      XmTextFindStringWcs(3X)
OSF/Motif							    OSF/Motif



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

SYNOPSIS


  ##iinncclluuddee <<XXmm//TTeexxtt..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gWWccss ((_w_i_d_g_e_t, _s_t_a_r_t, _w_c_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;;
       wwcchhaarr__tt	   **_w_c_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gWWccss locates the beginning position of	a specified wide
  character text string.  This routine searches	forward	or backward for	the
  first	occurrence of the string, starting from	the given start	position.  If
  a match is found, 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.

  _w_c_s_t_r_i_n_g
	 Specifies the wide character search string.

  _d_i_r_e_c_t_i_o_n
	 Indicates the search direction. It is relative	to the primary direc-
	 tion 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 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
			   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g((33XX)).
































































