RiverSoftAVG Products Help

Zoom Window Out
Larger Text | Smaller Text
Hide Page Header
Show Expanding Text
Printable Version
Send Mail Feedback
Save Permalink URL

Navigation: Code Documentation > RSCommon > RSEncodedBits > Classes

TRSEncodedBits Class

Extends the TBits class with methods for storing and retrieving simple types in the bits at any location.

Note
Floating point works with below 32 bits but the precision and range starts suffering drastically. Basically, the TRSEncodedBits class divides a floating point number into 1 bit Sign (PreserveSignBit = True), 1/4 Len Exponent, and 3/4 Len - 1 Mantissa. The class tries to fit the exponent into the +/-range of bits, e.g., if the exponent has 8 bits, the range of exponents can be -126 to 127. Exponent overflows can occur and are not flagged.

note Note

Floating point works with below 32 bits but the precision and range starts suffering drastically. Basically, the TRSEncodedBits class divides a floating point number into 1 bit Sign (PreserveSignBit = True), 1/4 Len Exponent, and 3/4 Len - 1 Mantissa. The class tries to fit the exponent into the +/-range of bits, e.g., if the exponent has 8 bits, the range of exponents can be -126 to 127. Exponent overflows can occur and are not flagged.

Namespace: RSEncodedBits

	Name	Description
	AsBitString[Integer,Integer]	Specifies a bit string ('0's and '1's) representation of the bits between Offset and Offset+Len.
	AsBoolean[Integer,Integer]	Specifies a boolean representation of the bits between Offset and Offset+Len.
	AsByte[Integer,Integer]	Specifies a byte representation of the bits between Offset and Offset+Len.
	AsDouble[Integer,Integer]	Specifies a double precision floating point representation of the bits between Offset and Offset+Len.
	AsFloat[Integer,Integer]	Specifies a single precision, floating point representation of the bits between Offset and Offset+Len.
	AsInt64[Integer,Integer]	Specifies a 64-bit integer representation of the bits between Offset and Offset+Len.
	AsInteger[Integer,Integer]	Specifies an integer representation of the bits between Offset and Offset+Len.
	AsString[Integer,Integer]	Specifies a bit string ('0's and '1's) representation of the bits between Offset and Offset+Len.
	PreserveSignBit	Specifies whether the encoded bits object should preserve the sign bit when converting between numbers and the bit representation. If the sign bit is preserved, then the number of bits used for the actual numeric representation is len-1.

Top

Name

Description

public method

Assign(TBits)

Assigns the bits to the current encoded bits object.

public method

Clone

Creates a copy of the encoded bits.

Note
It is the responsibility of the calling routine to free the cloned object.

public method

Decode(Integer,Integer)

Overloaded. Decodes the bits in the range from Offset to Offset+Len into a byte.

This method extracts bits from the object and returns the extracted bits.

Note
The size of the range is not checked so it can overflow the decoded value.

public method

Decode(Integer,Integer,Integer)

Overloaded. Decodes the bits in the range from Offset to Offset+Len into an array of bytes. The byte array is created by the method.

This method extracts bits from the object and returns the extracted bits.

Note
The size of the range is not checked so it can overflow the decoded value.

public method

Decode(Integer,Integer,PByte,Integer)

Overloaded. Decodes the bits in the range from Offset to Offset+Len into a byte location.

This method extracts bits from the object and returns the extracted bits.

Note
The size of the range is not checked so it can overflow memory.

public method

Decode(Integer,Integer,TRSBitByteArray)

Overloaded. Decodes the bits in the range from Offset to Offset+Len into an array of bytes. The size of the byte array is not changed by this routine. You need to be careful to allocate enough bytes for the bits.

This method extracts bits from the object and returns the extracted bits.

Note
The size of the range is not checked so it can overflow the decoded value.

public method

Encode(Integer,Integer,Byte)

Overloaded. Encodes the bits in the byte into the encoded bits object. The Offset to Offset+Len specifies the range within the object to place the byte.

Note
The size of the range is not checked so it can overflow within the object.

public method

Encode(Integer,Integer,PByte,Integer)

Overloaded. Encodes the bits in the byte into the encoded bits object. The Offset to Offset+Len specifies the range within the object to place the byte. The Size parameter specifies the number of bytes to encode.

Note
The size of the range is not checked so it can overflow within the object.

public method

Encode(Integer,Integer,TRSBitByteArray)

Overloaded. Encodes the bits in the byte array into the encoded bits object. The Offset to Offset+Len specifies the range within the object to place the byte. The Value array specifies the bytes to encode.

Note
The size of the range is not checked so it can overflow within the object.

public method

NumberOfOnes

Returns the number of 1 (on) bits in the object.

public method

NumberOfZeros

Returns the number of 0 (off) bits in the object.

public method

ToBitString

Returns a string of '1's and '0's that represent the bits in the object.

public method

ToString

Returns a string of '1's and '0's that represent the bits in the object.

Top

RiverSoftAVG Products Help

Reference