Class: BinaryStream

• Inheritance
• Description
• Class protocol
  • instance creation
• Instance protocol
  • accessing
  • initialization
  • misc
  • reading
• Examples

Inheritance:

   Object
   |
   +--Stream
      |
      +--BinaryStream

Package:

stx:libcompat

Category:

Compatibility-Squeak

Version:

rev: 1.1 date: 2018/05/08 18:14:47

user: cg

file: BinaryStream.st directory: libcompat

module: stx stc-classLibrary: libcompat

Description:

DO NOT DIRECTLY REFER TO THIS CLASS OR USE IT OTHERWISE IN YOUR CODE:

This is a mimicry class to allow some squeak code to be filed in without changing.
Its protocol is neither complete, nor fully compatible with the corresponding
squeak original class.

This stream is used (in squeak) for storage of binary data in either MSB or LSB 
byte order. In contrast to ST/X streams (where the MSB/LSB parameter is passed around
as argument), this one keeps it as a state, and provides the usual nextShort/nextInt
protocol without that parameter.
It is needed to port the Matlab reader (goodies/math).

By default, this stream is in MSB mode (network byte order) 

Class protocol:

 new

return an initialized instance

 on: aStream

return an initialized instance

Instance protocol:

 beBigEndian

 beLittleEndian

 rawStream: anotherStream

 initialize

Invoked when a new instance is created.

 position

 position: newPosition

 reset

 next: nBytes

 nextShort

 nextUnsignedShort

 peek

Examples:

  |bytes rawStream binaryStream val|

  bytes := #[1 2 3 4 5 6 7 8 9].
  rawStream := bytes readStream.
  binaryStream := BinaryStream on:rawStream.
  binaryStream beBigEndian.
  self assert:((val := binaryStream nextShort) = 16r0102).
  self assert:((val := binaryStream nextUnsignedShort) = 16r0304).
  binaryStream reset.
  binaryStream beLittleEndian.
  self assert:((val := binaryStream nextShort) = 16r0201).
  self assert:((val := binaryStream nextUnsignedShort) = 16r0403).