NAME

XmStringSegmentCreate — a compound string function that creates a compound string.

SYNOPSIS

#include <Xm/Xm.h> XmString XmStringSegmentCreate (text, charset, direction, separator)
char∗ text;
XmStringCharSet charset;
XmStringDirection direction;
Booleanseparator;

DESCRIPTION

XmStringSegmentCreate is a high-level function that assembles a compound string consisting of a character set identifier, a direction component, a text component, and an optional separator component. 

textSpecifies a null-terminated string to be used as the text component of the compound string. 

charsetSpecifies the character set identifier to be associated with the text.  This can be XmSTRING_DEFAULT_CHARSET, but this value does not comply with the AES, and it may be removed in future versions of Motif.  If the value is XmSTRING_DEFAULT_CHARSET, the routine derives the character set from the current language environment. 

directionSpecifies the direction of the text. 

separatorSpecifies separator addition.  If False, the compound string does not have a separator at the end.  If True, a separator immediately follows the text component. 

RETURN VALUE

Returns a new compound string. 

RELATED INFORMATION

XmStringCreate(3X). 

September 02, 1992