DUMP - dump vector.
Usage:
B:
dump( unit [, vector, size, format,
words_per_line, base_addr ] );
C:
void dump(FILE *unit [, void *vector, int size,
int format, int words_per_line,
void *base_addr] );
Where:
- unit
- is the output unit to which the dump should be directed.
- vector
- gives the address at which the dump is to start. The
default is memory location zero.
- size
- is the size of the vector to be dumped. This size is the
total number of words in the vector minus one, i.e. the
maximum index of the vector. If "size" is not
specified, it defaults to all of memory.
- format
- is a word containing up to four of the characters 'a',
'b', 'd', 'e', or 'o'. These signify that the dump is to
be in ASCII, BCD, decimal, EBCDIC, or octal,
respectively. If more than one format character is given
(e.g. 'oab'), each line of the vector is dumped in each
format in succession. The default format is 'o'.
- words_per_line
- dictates how many words of "vector" should be
displayed in each line of output. The default is eight.
- base_addr
- is the base from which the addresses appearing in the
dump begin. This defaults to memory location zero. To get
an absolute dump, you should set "base_addr" to
"vector".
Description:
DUMP writes out a formatted dump of a selected area of memory.
The output for the various output formats is arranged so that if
multiple formats are specified, the various interpretations of
each word are correctly aligned in columns.
A call with only a "unit" argument produces a
complete memory dump.
Notes:
In earlier releases of the package, the "unit"
argument was optional. It is now compulsory. (Since you can now
supply a FILE* pointer in place of the unit number, the function
would not be able to determine whether its first argument
referred to a I/O unit or a memory location.)
Copyright © 1996, Thinkage Ltd.