'\" t
...\" StrGeF.sgm /main/9 1996/09/08 21:05:31 rws $
.de P!
.fl
\!!1 setgray
.fl
\\&.\"
.fl
\!!0 setgray
.fl			\" force out current output buffer
\!!save /psv exch def currentpoint translate 0 0 moveto
\!!/showpage{}def
.fl			\" prolog
.sy sed -e 's/^/!/' \\$1\" bring in postscript file
\!!psv restore
.
.de pF
.ie     \\*(f1 .ds f1 \\n(.f
.el .ie \\*(f2 .ds f2 \\n(.f
.el .ie \\*(f3 .ds f3 \\n(.f
.el .ie \\*(f4 .ds f4 \\n(.f
.el .tm ? font overflow
.ft \\$1
..
.de fP
.ie     !\\*(f4 \{\
.	ft \\*(f4
.	ds f4\"
'	br \}
.el .ie !\\*(f3 \{\
.	ft \\*(f3
.	ds f3\"
'	br \}
.el .ie !\\*(f2 \{\
.	ft \\*(f2
.	ds f2\"
'	br \}
.el .ie !\\*(f1 \{\
.	ft \\*(f1
.	ds f1\"
'	br \}
.el .tm ? font underflow
..
.ds f1\"
.ds f2\"
.ds f3\"
.ds f4\"
.ta 8n 16n 24n 32n 40n 48n 56n 64n 72n 
.TH "XmStringGetNextTriple" "library call"
.SH "NAME"
\fBXmStringGetNextTriple\fP \(em An XmString function that returns the type, length, and value of the next component in the compound string
.iX "XmStringGetNextTriple"
.SH "SYNOPSIS"
.PP
.nf
#include <Xm/Xm\&.h>
\fBXmStringComponentType \fBXmStringGetNextTriple\fP\fR(
\fBXmStringContext \fBcontext\fR\fR,
\fBunsigned int \fB*length\fR\fR,
\fBXtPointer \fB*value\fR\fR);
.fi
.SH "DESCRIPTION"
.PP
\fBXmStringGetNextTriple\fP returns the type, length, and value of the
next component in the compound string identified by \fIcontext\fP\&.
This function returns one component at a time\&.
.IP "\fIcontext\fP" 10
Specifies the string context structure that was allocated by the
\fBXmStringInitContext\fP function\&.
.IP "\fIlength\fP" 10
Specifies a pointer to the length of the value of the returned component\&.
.IP "\fIvalue\fP" 10
Specifies a pointer to the value of the returned component\&.
If the returned value is not NULL, the function allocates space to hold
the returned value\&.
When the application no longer needs the returned compound string,
the application should call
\fBXtFree\fP\&.
.SH "RETURN"
.PP
Returns the type of the component found\&. Refer to the
\fBXmStringComponentType\fP(3) reference page for a list of component types\&.
.SH "RELATED"
.PP
\fBXmDirection\fP(3),
\fBXmString\fP(3),
\fBXmStringComponentType\fP(3),
\fBXmStringGetNextComponent\fP(3), and
\fBXmStringPeekNextTriple\fP(3)\&.
...\" created by instant / docbook-to-man, Sun 22 Dec 1996, 20:31