xmstringgetnextsegment(3x) [osf1 man page]

XmStringGetNextSegment(3X)												XmStringGetNextSegment(3X)

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, tag, direction, separator)
	       XmStringContext context;
	       char **text;
	       XmStringCharSet *tag;
	       XmStringDirection *direction;
	       Boolean *separator;

DESCRIPTION

       XmStringGetNextSegment  fetches	the octets in the next segment; repeated calls fetch sequential segments.  The text, tag, and direction of
       the fetched segment are returned each time.  A Boolean status is returned to indicate whether a	valid  segment	was  successfully  parsed.
       Specifies  the  string context structure which was allocated by the XmStringInitContext function.  Specifies a pointer to a null terminated
       string.	Specifies a pointer to the font list element tag associated with the text.  Specifies a pointer to  the  direction  of	the  text.
       Specifies whether the next component of the compound string is a separator.

RETURN VALUE

       Returns True if a valid segment is found.

SEE ALSO

       XmStringCreate(3X), XmStringInitContext(3X)

															XmStringGetNextSegment(3X)

XmStringGetNextSegment(library call)									      XmStringGetNextSegment(library call)

NAME

       XmStringGetNextSegment -- A compound string function that fetches the bytes in the next segment of a compound string

SYNOPSIS

       #include <Xm/Xm.h>
       Boolean XmStringGetNextSegment(
       XmStringContext context,
       char **text,
       XmStringTag *tag,
       XmStringDirection *direction,
       Boolean *separator);

DESCRIPTION

       This  routine  is obsolete and exists for compatibility with previous releases. To read the contents of a compound string, read each compo-
       nent of the string with XmStringGetNextTriple. This XmString function returns the type, length, and value of the next component in the com-
       pound  string.	XmStringGetNextSegment fetches the bytes in the next segment; repeated calls fetch sequential segments. The text, tag, and
       direction of the fetched segment are returned each time. A Boolean status is returned to indicate whether a valid segment was  successfully
       parsed.

       If  the function returns True, then the function allocates space to hold the returned text and tag. The application is responsible for man-
       aging the allocated space. The application can recover the allocated space by calling XtFree.

       context	 Specifies the string context structure which was allocated by the XmStringInitContext function

       text	 Specifies a pointer to a NULL-terminated string

       tag	 Specifies a pointer to the font list element tag associated with the text

       direction Specifies a pointer to the direction of the text

       separator Specifies whether the next component of the compound string is a separator

RETURN

       Returns True if a valid segment is found.

RELATED

       XmStringCreate(3) and XmStringInitContext(3).

													      XmStringGetNextSegment(library call)