ultrix man page for dwtgetnextsegment

DwtGetNextSegment(3Dwt) 												   DwtGetNextSegment(3Dwt)

Name
       DwtGetNextSegment - Gets information about the next segment in the compound-string.

Syntax
       int DwtGetNextSegment(context, text_return,
			    charset_return, direction_r_to_l_return,
			    lang_return, rend_return)
	    DwtCompStringContext *context;
	    char *text_return;
	    long *charset_return;
	    int *direction_r_to_l_return;
	    long *lang_return;
	    long *rend_return;

Arguments
       context	 Specifies  the  context  for the call to DwtInitGetSegment.  You initialize the context by calling DwtInitGetSegment, and it gets
		 incremented each time you call DwtGetNextSegment.

       text_return
		 Returns the text in the next segment.

       charset_return
		 Returns  the  character  set  in  the	next  segment.	 Values  for  this  argument  can  be	found	in   the   required   file
		 /usr/include/cda_def.h.

       direction_r_to_l_return
		 Returns the character direction value.

       lang_return
		 For future use.

       rend_return
		 For future use.

Description
       The  DwtGetNextSegment  function obtains information about the next segment of the compound-string as determined by the context.  The space
       for the resulting compound-string is allocated with this function.  After using this function,  you  should  free  this	space  by  calling
       XtFree.

Return Values
       This function returns one of these status return constants:

       DwtEndCS 	 The context is at the end
			 of the compound-string.
       DwtFail		 The context is not valid.
       DwtSuccess	 Normal completion.

See Also
       DwtInitGetSegment(3Dwt)
       Guide to the XUI Toolkit: C Language Binding
       Guide to the XUI Toolkit Intrinsics: C Language Binding

															   DwtGetNextSegment(3Dwt)