NAME

XctCreate — create a XctData structure for parsing a Compound Text string. 

SYNOPSIS

#include <X11/Xmu/Xct.h>

XctData XctCreate(string, length, flags)
      XctString string;
      int length;
      XctFlags flags;

ARGUMENTS

stringSpecifies the Compound Text string. 

lengthSpecifies the number of bytes in string. 

flagsSpecifies parsing control flags. 

DESCRIPTION

XctCreate creates an XctData structure for parsing a Compound Text string.  The string need not be NULL-terminated.  The following flags are defined to control parsing of the string:

XctSingleSetSegments
This means that returned segments should contain characters from only one set (C0, C1, GL, GR).  When this is requested, XctSegment is never returned by XctNextItem, instead XctC0Segment, XctC1Segment, XctGlSegment, and XctGRSegment are returned.  C0 and C1 segments are always returned as singleton characters. 

XctProvideExtensions
This means that if the Compound Text string is from a higher version than this code is implemented to, then syntactically correct but unknown control sequences should be returned as XctExtension items by XctNextItem.  If this flag is not set, and the Compound Text string version indicates that extensions cannot be ignored, then each unknown control sequence will be reported as an XctError. 

XctAcceptC0Extensions
This means that if the Compound Text string is from a higher version than this code is implemented to, then unknown C0 characters should be treated as if they were legal, and returned as C0 characters (regardless of how XctProvideExtensions is set) by XctNextItem.  If this flag is not set, then all unknown C0 characters are treated according to XctProvideExtensions. 

XctAcceptC1Extensions
This means that if the Compound Text string is from a higher version than this code is implemented to, then unknown C1 characters should be treated as if they were legal, and returned as C1 characters (regardless of how XctProvideExtensions is set) by XctNextItem.  If this flag is not set, then all unknown C1 characters are treated according to XctProvideExtensions. 

XctHideDirection
This means that horizontal direction changes should be reported as XctHorizontal items by XctNextItem.  If this flag is not set, then direction changes are not returned as items, but the current direction is still maintained and reported for other items.  The current direction is given as an enumeration, with the values XctUnspecified, XctLeftToRight, and XctRightToLeft. 

XctFreeString
This means that XctFree should free the Compound Text string that is passed to XctCreate.  If this flag is not set, the string is not freed. 

XctShiftMultiGRToGL
This means that XctNextItem should translate GR segments on-the-fly into GL segments for the GR sets: GB2312.1980-1, JISX0208.1983-1, and KSC5601.1987-1. 

SEE ALSO

XctFree, XctNextItem, XctReset. 

Xlib Reference Manual