Bytes Class

Methods of the Bytes class enable you to perform specific tasks related to Bytes objects.

LNCPP20688 Table 13-9 Summary of Bytes Methods

Method	Summary
Bytes()	`Bytes` class constructor.
byteAt()	Returns the byte at the specified position of the `Bytes` object.
getBytes()	Returns a byte array from the `Bytes` object.
isNull()	Tests whether the `Bytes` object is `NULL`.
length()	Returns the number of bytes in the `Bytes` object.
operator=()	Assignment operator for `Bytes` class.
setNull()	Sets the `Bytes` object to `NULL`.

LNCPP20689

Bytes()

Bytes class constructor.

Syntax	Description
Bytes( Environment *env = NULL);	Creates a `Bytes` object.
Bytes( unsigned char value, unsigned int count unsigned int offset = 0, const Environment env = NULL);	Creates a `Bytes` object that contains a subarray of bytes from a character array.
Bytes( const Bytes &e);	Creates a copy of a `Bytes` object, use the syntax

Parameter	Description
env	Environment
value	Initial value of the new object
count	The size of the subset of the character array that is copied into the new bytes object
offset	The first position from which to begin copying the character array
e	The source `Bytes` object.

LNCPP20690

byteAt()

Returns the byte at the specified position in the Bytes object.

LNCPP20691Syntax

unsigned char byteAt(
   unsigned int index) const;

Parameter	Description
index	The position of the byte to be returned from the `Bytes` object; the first byte of the `Bytes` object is at 0.

LNCPP20692

getBytes()

Copies bytes from a Bytes object into the specified byte array.

LNCPP20693Syntax

void getBytes(
   unsigned char *dst,
   unsigned int count,
   unsigned int srcBegin = 0,
   unsigned int dstBegin = 0) const;

Parameter	Description
dst	The destination buffer into which data from the `Bytes` object is to be written.
count	The number of bytes to copy.
srcBegin	The starting position at which data is to be read from the `Bytes` object; the position of the first byte in the `Bytes` object is at 0.
dstBegin	The starting position at which data is to be written in the destination buffer; the position of the first byte in `dst` is at 0.

LNCPP20694

isNull()

Tests whether the Bytes object is atomically NULL. If the Bytes object is atomically NULL, then TRUE is returned; otherwise FALSE is returned.

LNCPP20695Syntax