XmStringGetNextSegment(3X) — Subroutines
OSF
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.