This is an old revision of the document!
CIGAL Reference Manual, Chapter 2 (Commands): dmread
usage: dmread filename datavarb recflg [hdrtxt hdrflag]
DMREAD reads data written by DMWRITE from the named data management (DM) archive file. This file format is described in DM Format. Records read by DMREAD can be displayed on the screen (if they are text records) or stored in a CIGAL data variable. Records in a DM file are accessed either by record number or by record type, using the RECFLG argument.
FILENAME must be the name of a data file in archive format.
If the archive file is the only argument, DMREAD will display a list of all records in the file.
RECFLG can be:
DATAVARB
If a character string argument is specified for HDRTXT it will receive the comment text associated with the retrieved record. If HDRFLAG is 1, DMREAD returns header information for the specified record by loading DATAVARB with a 7 element LONG array containing the following information:
RECNUM Record number RECSIZE Size of record in bytes RECOFFSET Byte offset of data RECTYPE Record type WTYPE PIXTYPE for data NX X dim, or 1 + # of Xprime values if XXprime format WTYPEY PIXTYPE for Xprime data (if NVALS > 0)
See Also:
DMWRITE(6)