Class: HexDumpUtility

• Inheritance
• Description
• Class protocol
  • dumping
• Instance protocol
  • accessing
  • private

Inheritance:

   Object
   |
   +--HexDumpUtility

Package:

stx:libtool

Category:

Interface-Tools-File

Version:

rev: 1.5 date: 2024/04/22 17:42:28

user: stefan

file: HexDumpUtility.st directory: libtool

module: stx stc-classLibrary: libtool

Description:

utilitiy to generate hex dumps, as shown eg. in the FileBrowser

Class protocol:

 dump: dataOrFileStream

dump a byteArray or stream;
return an object which behaves like a collection of lines (i.e. stringCollection),
but actually generates the lines on the fly, as they are accessed (a virtual array)

 dump: dataOrFileStream virtualStart: virtualStart

dump a byteArray or stream, generating addresses as if the dump starts at virtualStart;
return an object which behaves like a collection of lines (i.e. stringCollection),
but actually generates the lines on the fly, as they are accessed (a virtual array)

Instance protocol:

 dataOrFileStream: dataOrFileStreamArg numberBase: numberBaseArg offsetNumberBase: offsetNumberBaseArg addrDigits: addrDigitsArg virtualStart: virtualStartArg characterEncoding: characterEncodingArg highlightRangeHolderOrNil: highlightRangeHolderOrNilArg highlightBitRangeHolderOrNil: highlightBitRangeHolderOrNilArg firstHighlightedLineNrHolder: firstHighlightedLineNrHolderArg

 show7BitAscii: aBoolean

 generateHexDump

utility helper: generate a hex (or octal) dump with addresses;
characterEncodingSymbol determines how characters are to be shown in the right (character) columns.
By default, this is iso8859-1, but supported are also ebcdic and ascii7,
to support display of alien encoded binary data.
highlightRangeHolderOrNil may hold on an interval (0-based) to mark a range of bytes.
highlightBitRangeHolder may hold on an interval (0-based) to mark a range of bits.
numberBaseArg defines the radix of the bytes, offsetBase the radix of the address.
Returns a virtual array of lines.

 generateLine: lineNr

fetch possible byte/bit selection ranges