FreeBSD Manual Pages
XmStringGetNextSegment(3) Library Functions Manual XmStringGetNextSegment(3) 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 re- leases. To read the contents of a compound string, read each component of the string with XmStringGetNextTriple. This XmString function returns the type, length, and value of the next com- ponent in the compound 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 sta- tus 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 managing the al- located 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(3)
NAME | SYNOPSIS | DESCRIPTION | RETURN | RELATED
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=XmStringGetNextSegment&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>