Implements read-only stream access to memory.

TIdReadMemoryStream = class(TCustomMemoryStream)

TIdReadMemoryStream is a TCustomMemoryStream descendant, and is used to provide fast, read-only, stream-based access to values in memory. TIdReadMemoryStream implements the SetPointer and Write methods from the abstract ancestor class.

TIdReadMemoryStream is used internally in the implementation of some Indy methods like TIdEncoder.Encode, TIdHash32.HashValue, TIdHash16.HashValue, and TIdHash128.HashValue.

Assigns the memory buffer associated with the memory stream.

procedure SetPointer(Ptr: Pointer; Size: Longint);

Pointer to the memory buffer for the stream.

Size of the buffer for the stream.

SetPointer is a procedure that assigns the internal memory buffer associated with the memory stream. SetPointer is a public method in TIdReadMemoryStream, and calls the inherited method using Ptr and Size as arguments.

Ptr is as pointer to the internal buffer to be assigned to Memory. Size is the number of bytes allocated to the buffer in Ptr.

SetPointer sets the Position of the memory stream to byte 0 (zero) using Seek prior to exiting the method.

Note: SetPointer does not free the existing value of Memory, if any, when it replaces the memory buffer. Descendant classes that use SetPointer to replace an existing stream memory pool should free the memory pointed to by the Memory property before calling SetPointer to replace the memory buffer.

Overrides the default write behavior for the read-only memory stream.

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

Values to be written. Ignored.

Number of bytes to be written. Ignored.

LongInt - Numer of bytes written. Always returns 0 (zero).

Write is a LongInt function that is reimplemented in TIdReadMemoryStream to override the default behavior for the custom memory stream. TIdReadMemoryStream is a read-only stream, and the return value for the Write method will always be 0 (zero).