


XmStringGetNextSegment(3X)			   XmStringGetNextSegment(3X)
OSF/Motif							    OSF/Motif



NAME
  XXmmSSttrriinnggGGeettNNeexxttSSeeggmmeenntt - A compound string function that fetches the octets
  in the next segment of a compound 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mSSttrriinnggGGeettNNeexxttSSeeggmmeenntt ((_c_o_n_t_e_x_t, _t_e_x_t, _t_a_g, _d_i_r_e_c_t_i_o_n,
	    _s_e_p_a_r_a_t_o_r))
       XXmmSSttrriinnggCCoonntteexxtt_c_o_n_t_e_x_t;;
       cchhaarr	      ****_t_e_x_t;;
       XXmmSSttrriinnggCChhaarrSSeett**_t_a_g;;
       XXmmSSttrriinnggDDiirreeccttiioonn**_d_i_r_e_c_t_i_o_n;;
       BBoooolleeaann	      **_s_e_p_a_r_a_t_o_r;;

DESCRIPTION
  XXmmSSttrriinnggGGeettNNeexxttSSeeggmmeenntt fetches the octets in the next	segment; repeated
  calls	fetch sequential segments.  The	_t_e_x_t, _t_a_g, and _d_i_r_e_c_t_i_o_n of the
  fetched segment are returned each time.  A Boolean status is returned	to
  indicate whether a valid segment was successfully parsed.

  _c_o_n_t_e_x_t   Specifies the string context structure which was allocated by the
	    XXmmSSttrriinnggIInniittCCoonntteexxtt	function.

  _t_e_x_t	    Specifies a	pointer	to a null terminated string.

  _t_a_g	    Specifies a	pointer	to the font list element tag associated	with
	    the	text.

  _d_i_r_e_c_t_i_o_n Specifies a	pointer	to the direction of the	text.

  _s_e_p_a_r_a_t_o_r Specifies whether the next component of the	compound string	is a
	    separator.

RETURN VALUE
  Returns True if a valid segment is found.

RELATED	INFORMATION
  XXmmSSttrriinnggCCrreeaattee((33XX)) and XXmmSSttrriinnggIInniittCCoonntteexxtt((33XX)).


















