TROConstantMemoryStream

Overview

TROConstantMemoryStream is a custom memory stream implementation, optimized for read-only access.

Use Case

This class was originally implemented for internal use within the Remoting SDK library, but provided publicly for your convenience. You can use TROConstantMemoryStream wherever a un-modifiable memory stream optimized for fast read-only access is needed.

Location

 

constructor Create  overload    (declared in TROBinaryMemoryStream)

Creates a new instance.

constructor Create

constructor Create (TCustomMemoryStream, Boolean)  reintroduce

Creates a new instance with a supplied values.

constructor Create(Source: TCustomMemoryStream; aFreeOldStream: Boolean)

Parameters:

  • Source: stream
  • aFreeOldStream: allows to destroy aStream after copying of his content

constructor Create (AnsiString)  overload    (declared in TROBinaryMemoryStream)

Creates a new instance from given string.

constructor Create(const Value: AnsiString)

Parameters:

  • Value: given string

constructor Create (ROAnsiString)  overload    (declared in TROBinaryMemoryStream)

Creates a new instance from given string.

constructor Create(const Value: ROAnsiString)

Parameters:

  • Value: given string

Assign  virtual    (declared in TROBinaryMemoryStream)

Creates a new instance from given string.

procedure Assign(Source: TStream)

Parameters:

  • Source: given string

CapacityIncrement    (declared in TROBinaryMemoryStream)

The amount by which the capacity of the stream is automatically incremented when its size becomes greater than its capacity.

property CapacityIncrement: Integer read write

Clone    (declared in TROBinaryMemoryStream)

Creates and returns a new memory stream that is an identical copy of the current stream. The new stream will receive its own copy of the data, and any changes to data or stream position will not affect the original version.

function Clone: TROBinaryMemoryStream

LoadFromHexString    (declared in TROBinaryMemoryStream)

Creates a new instance from given string.

procedure LoadFromHexString(const Value: ROAnsiString)

Parameters:

  • Value: given string

LoadFromString (AnsiString)  overload    (declared in TROBinaryMemoryStream)

Creates a new instance from given string.

procedure LoadFromString(const Value: AnsiString)

Parameters:

  • Value: given string

LoadFromString (ROAnsiString)  overload    (declared in TROBinaryMemoryStream)

Creates a new instance from given string.

procedure LoadFromString(const Value: ROAnsiString)

Parameters:

  • Value: given string

LoadFromUTF8String    (declared in TROBinaryMemoryStream)

Creates a new instance from given string.

procedure LoadFromUTF8String(const Value: UnicodeString)

Parameters:

  • Value: given string

ToHexString    (declared in TROBinaryMemoryStream)

Emits the data in the stream as a string containing hexadecimal characters. For each byte in the original stream, two characters between '0' and 'F' will be emitted to the string.

function ToHexString: ROAnsiString

ToReadableString    (declared in TROBinaryMemoryStream)

Emits the data in the stream as an ansi string for display purposes. For each byte in the original stream, the corresponding ASCII character will be emitted to the string if the value is $0D or between $20 and $7F, and a "period" character will be emitted otherwise. This results in a string that can cleanly be displayed and does not contain ASCII control characters.

function ToReadableString: ROAnsiString

ToString    (declared in TROBinaryMemoryStream)

Emits the data in the stream as an ansi string. For each byte in the original stream, the corresponding ANSI character will be emitted to the string.

function ToString: ROAnsiString

Write  override

Raises exception that Stream is read-only.

function Write(const Buffer: ; Count: Longint): Longint

Parameters:

  • Buffer: Buffer
  • Count: Count

WriteAnsiString    (declared in TROBinaryMemoryStream)

Creates a new instance from given string.

function WriteAnsiString(const Value: ROAnsiString): Integer

Parameters:

  • Value: given string

 

CapacityIncrement    (declared in TROBinaryMemoryStream)

The amount by which the capacity of the stream is automatically incremented when its size becomes greater than its capacity.

property CapacityIncrement: Integer read write

 

constructor Create  overload    (declared in TROBinaryMemoryStream)

Creates a new instance.

constructor Create

constructor Create (TCustomMemoryStream, Boolean)  reintroduce

Creates a new instance with a supplied values.

constructor Create(Source: TCustomMemoryStream; aFreeOldStream: Boolean)

Parameters:

  • Source: stream
  • aFreeOldStream: allows to destroy aStream after copying of his content

constructor Create (AnsiString)  overload    (declared in TROBinaryMemoryStream)

Creates a new instance from given string.

constructor Create(const Value: AnsiString)

Parameters:

  • Value: given string

constructor Create (ROAnsiString)  overload    (declared in TROBinaryMemoryStream)

Creates a new instance from given string.

constructor Create(const Value: ROAnsiString)

Parameters:

  • Value: given string

Assign  virtual    (declared in TROBinaryMemoryStream)

Creates a new instance from given string.

procedure Assign(Source: TStream)

Parameters:

  • Source: given string

Clone    (declared in TROBinaryMemoryStream)

Creates and returns a new memory stream that is an identical copy of the current stream. The new stream will receive its own copy of the data, and any changes to data or stream position will not affect the original version.

function Clone: TROBinaryMemoryStream

LoadFromHexString    (declared in TROBinaryMemoryStream)

Creates a new instance from given string.

procedure LoadFromHexString(const Value: ROAnsiString)

Parameters:

  • Value: given string

LoadFromString (AnsiString)  overload    (declared in TROBinaryMemoryStream)

Creates a new instance from given string.

procedure LoadFromString(const Value: AnsiString)

Parameters:

  • Value: given string

LoadFromString (ROAnsiString)  overload    (declared in TROBinaryMemoryStream)

Creates a new instance from given string.

procedure LoadFromString(const Value: ROAnsiString)

Parameters:

  • Value: given string

LoadFromUTF8String    (declared in TROBinaryMemoryStream)

Creates a new instance from given string.

procedure LoadFromUTF8String(const Value: UnicodeString)

Parameters:

  • Value: given string

ToHexString    (declared in TROBinaryMemoryStream)

Emits the data in the stream as a string containing hexadecimal characters. For each byte in the original stream, two characters between '0' and 'F' will be emitted to the string.

function ToHexString: ROAnsiString

ToReadableString    (declared in TROBinaryMemoryStream)

Emits the data in the stream as an ansi string for display purposes. For each byte in the original stream, the corresponding ASCII character will be emitted to the string if the value is $0D or between $20 and $7F, and a "period" character will be emitted otherwise. This results in a string that can cleanly be displayed and does not contain ASCII control characters.

function ToReadableString: ROAnsiString

ToString    (declared in TROBinaryMemoryStream)

Emits the data in the stream as an ansi string. For each byte in the original stream, the corresponding ANSI character will be emitted to the string.

function ToString: ROAnsiString

Write  override

Raises exception that Stream is read-only.

function Write(const Buffer: ; Count: Longint): Longint

Parameters:

  • Buffer: Buffer
  • Count: Count

WriteAnsiString    (declared in TROBinaryMemoryStream)

Creates a new instance from given string.

function WriteAnsiString(const Value: ROAnsiString): Integer

Parameters:

  • Value: given string