XmStringGetNextComponent - A compound string function that returns the type and value of the next component in a compound string
#include <Xm/Xm.h> XmStringComponentType XmStringGetNextComponent (context, text, tag, direction, unknown_tag, unknown_length, unknown_value) XmStringContext context; char **text; XmStringCharSet *tag; XmStringDirection *direction; XmStringComponentType *unknown_tag; unsigned short *unknown_length; unsigned char **unknown_value;
XmStringGetNextComponent returns the type and value of the next component in the compound string identified by context. It is a low-level component function. Components are returned one at a time. On return, only some output parameters will be valid; which ones can be determined by examining the return status. In the case of text, tag, and direction components, only one output parameter is valid. If the return status indicates an unknown component was encountered, the font list element tag, length, and value are returned. This function allocates the space necessary to hold returned values; freeing this space is the caller's responsibility.
Returns the type of component found. Following are the possible values:
This component is obsolete and remains for compatibility with previous releases. It has been replaced by XmSTRING_COMPONENT_FONTLIST_ELEMENT_TAG.
XmStringCreate(3X) and XmStringInitContext(3X).