Museum

Home

Lab Overview

Retrotechnology Articles

⇒ Online Manual

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

XmStringCreate(3X)

XmStringInitContext(3X)

XmStringGetNextSegment(3X)  —  Subroutines

OSF/Motif

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)
XmStringContextcontext;
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. 

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

textSpecifies a pointer to a null terminated string. 

tagSpecifies a pointer to the font list element tag 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(3X) and XmStringInitContext(3X). 

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026