Print Method for Binary File Format

Share:

Description

This function displays a "rawFormat" object. Each line of output contains a binary offset, the binary data in a raw machine format, and an interpretation of the data in a human-readable format. The format consists of one or more sub-blocks and a heading line is added for each block. The object contains parameters controlling the format of the display, some of which may be overridden in the call to print.

Usage

1
2
3
## S3 method for class 'rawFormat'
print(x, sep1 = "  :  ", sep2 = "  |  ",
                  blockHead = TRUE, blockChar = "=", page = FALSE, ...)

Arguments

x

A "rawFormat" object.

sep1

A separator to insert between the format offset and the machine format.

sep2

A separator to insert between the machine format and the human-readable format.

blockHead

A logical indicating whether to print a header between blocks of the format.

blockChar

The character used as a prefix to the block names for printing headers between blocks.

page

If TRUE the output is sent to the file viewer specified by getOption("pager").

...

Other arguments to print.

Details

Information on the number of bytes on each line, the machine representation of each byte and the human-readable format are all taken from the taken from the "rawBlock" elements of the "rawFormat" object. Consequently each block can have a quite different appearance. Considerable effort is made to line up the separators across all blocks within the format.

Author(s)

Paul Murrell

See Also

readFormat as.character.rawFormat

Examples

1
2
3
4
fileFormat <- readFormat(hexViewFile("rawTest.int"),
                         memFormat(int1=integer4, int2=integer4))
print(fileFormat)
print(fileFormat, sep2=":")