NAME

XmStringGetNextSegment — a compound string function that fetches the octets in the next segment of a compound string. 

SYNOPSIS

#include <Xm/Xm.h> Boolean XmStringGetNextSegment (context, text, charset, direction, separator)
XmStringContextcontext;
char∗∗ text;
XmStringCharSet∗ charset;
XmStringDirection ∗ direction;
Boolean∗ separator;

DESCRIPTION

XmStringGetNextSegment fetches the octets in the next segment; repeated calls fetch sequential segments.  The text, charset, and direction of the fetched segment are returned each time.  A Boolean status is returned to indicate whether a valid segment was successfully parsed. 

contextSpecifies the string context structure which was allocated by the XmStringInitContext function. 

textSpecifies a pointer to a null terminated string. 

charsetSpecifies a pointer to the character set identifier associated with the text. 

directionSpecifies a pointer to the direction of the text. 

separatorSpecifies whether the next component of the compound string is a separator. 

RETURN VALUE

Returns True if a valid segment is found. 

RELATED INFORMATION

XmStringCreate(3XM) and XmStringInitContext(3XM). 

NEWS-OSRelease 4.2.1R