Convert Binary File Format into Strings

Description

This function takes a "rawFormat" object and generates human-readable strings for displaying the format. Each string 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.

Usage

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

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.

...

Other arguments to as.character.

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.

Value

A character vector.

Author(s)

Paul Murrell

See Also

readFormat print.rawFormat

Examples

1
2
3
fileFormat <- readFormat(hexViewFile("rawTest.int"),
                         memFormat(int1=integer4, int2=integer4))
as.character(fileFormat)