PRDITM(3g) — Subroutines
Name
PRDITM − Reads the data record of the current metafile item and writes the record to its last argument.
Operating States: PHOP, WSOP, ∗, ∗
PHIGS standard function
Syntax
PRDITM (WKID, MIDRL, MLDR, DATREC)
Argument Data Type Access Description
---------------------------------------------------------------------------
WKID Integer Read Workstation identifier.
MIDRL Integer Read Maximum length of the data record
(the number of characters in the
data record array). The range is
0 to IDRL. If MIDRL = 0,
Digital PHIGS ignores the record.
If MIDRL < IDRL, Digital PHIGS loses
the excess information. If
MIDRL >= IDRL, Digital PHIGS reads
the whole data record. PGTITM
returns the IDRL value.
MLDR Integer Read Dimension of the item data record.
DATREC Character ∗80 Write Data record.
---------------------------------------------------------------------------
Description
PRDITM reads the data record of the current metafile item and then writes the record to its last argument.
You should compare the maximum length for the data record (as passed to this function) with the actual length of the data record (as PGTITM writes to one of its arguments). If the actual size of the record is larger than the maximum allocated space, Digital PHIGS truncates the record, causing loss of information. To skip an item, specify the value 0 as the maximum record length.
After returning the data record to the application program, this function makes the next item in the metafile the current item.
Digital PHIGS Version 3.1 does not support this function.
See Also
PGTITM
PIITM
PWITM