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.