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

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

text_returnReturns 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_returnFor future use.

rend_returnFor 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.