GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  XMSTRINGGETNEXTSEGMENT (3)

NAME

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

CONTENTS

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 component of the string with XmStringGetNextTriple. This XmString function returns the type, length, and value of the next component 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 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 managing 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).

Search for    or go to Top of page |  Section 3 |  Main Index


XMSTRINGGETNEXTSEGMENT (3) -->

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.