as.character.rawFormat: 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

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

Arguments

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.

Value

A character vector.

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.

Examples

Run this code

# NOT RUN {
fileFormat <- readFormat(hexViewFile("rawTest.int"),
                         memFormat(int1=integer4, int2=integer4))
as.character(fileFormat)
# }