DUMPA - dump an array.

Usage:

B:
   dumpa( vector, nwds [, heading, format] );

C:
   void dumpa(const void *vector, int nwds,
              [const char *heading, const char *format]);

Where:

vector

points to the vector to be dumped.

nwds

is the number of words to be dumped.

heading

is a string which will be printed before the vector is dumped, thus helping to identify the vector.

format

is a PRINTF-type format string, specifying the format in which the words of "vector" are to be printed. This is useful if "vector" is known to contain ASCII characters or pointers to ASCII strings. If you do specify a "format", it should be of the form " %d", " %s", etc. If no "format" is specified, the default is " %o" and the words of "vector" are dumped in octal.

Description:

DUMPA displays "vector[0]" through "vector[nwds]" on the current write unit. DUMPA always writes four words of the vector per line, even if a format is supplied.

Examples:

dumpa(buffer, 63, "catalogue block dump");
    Dumps buffer[0] through buffer[63] in octal.
dumpa(buffer, 63);
    As above, but without the identifying header.
dumpa(buffer, 63, "quite a few strings", " %s");
    Dumps the strings in buffer[0] through buffer[63],
    four per line.

See Also:

expl b lib printf

Copyright © 1996, Thinkage Ltd.