.\" @(#)PEXDecodeOCs.3 1.4 95/03/24 SMI;
.so man3/pex.macs
.TH PEXDecodeOCs 3 "May 1995" "Solaris PEXlib Reference Manual" ""
.SH NAME
PEXDecodeOCs \- Decode Output Commands
.SH SYNTAX
.HP
PEXOCData *PEXDecodeOCs\^(\^int \fIfloat_format\fP\^, unsigned long \fIoc_count\fP\^, unsigned long \fIlength\fP\^, char *\fIencoded_ocs\fP\^)
.SH PARAMETERS
.TP 1i
\fIfloat_format\fP
The floating point format of the encoded output commands (
.B PEXIEEE_754_32,
.B PEXDEC_F_Floating,
.B PEXIEEE_754_64,
.B PEXDEC_D_Floating
).
.TP
\fIoc_count\fP
The number of output commands represented in the encoded output commands.
.TP
\fIlength\fP
The length, in bytes, of the encoded output commands.
.TP
\fIencoded_ocs\fP
A pointer to the encoded output commands.
.SH RETURNS
A pointer to the decoded output commands; a null pointer if unsuccessful or
if zero output commands specified.
.SH DESCRIPTION
.\" indexing
.IX PEXDecodeOCs
.IX "Output Commands" PEXDecodeOCs
.LP
This function has no visible effect.  Encoded output commands are passed in
and the data typically passed as parameters to output attribute or primitive
functions is returned in memory allocated by PEXlib.
.BR PEXFreeOCData (3)
should be called to deallocate the memory.
.LP
A null pointer will be returned if the specified floating point format is not
supported.
.LP
Any text or annotation text primitives are returned as encoded text or encoded
annotation text.
.LP
.BR PEXCountOCs (3)
can be used to determine the number of output commands in the encoded list if
that information is not already available.
.SH ERRORS
None
.SH SEE ALSO
.LP
.nf
.BR PEXEncodeOCs (3)
.BR PEXCountOCs (3)
.fi