BMallocIO

Constructor and Destructor

BMallocIO()

BMallocIO::BMallocIO()

The BMallocIO constructor creates an empty object and sets the default block size to 256 bytes. The constructor doesn’t allocate any memory; memory is allocated when you first write to the object or when you call SetSize() to set the amount of memory.

~BMallocIO()

BMallocIO::~BMallocIO()

The BMallocIO destructor frees all memory that was allocated by the object.

Member Functions

Buffer(), BufferLength()

const void *BMallocIO::Buffer() const

size_t BMallocIO::BufferLength() const

Buffer() returns a pointer to the memory that the BMallocIO object has allocated, or NULL if it hasn’t yet had occasion to allocate any memory.

BufferLenth() returns the number of data bytes in the buffer (not necessarily the full number of bytes that were allocated).

ReadAt()

virtual ssize_t BMallocIO::ReadAt(off_t position, void *buffer, size_t numBytes)

Reads up to numBytes of data from the object and copies it into the buffer. Returns the actual number of bytes placed in the buffer. The data is read beginning at position offset.

This function doesn’t read beyond the end of the data. If there are fewer than numBytes of data available at the position offset, it reads only through to the last data byte and returns a smaller number than numBytes. If position is out of range, it returns 0.

Seek(), Position()

virtual off_t BMallocIO::Seek(off_t position, int32 mode)

virtual off_t BMallocIO::Position() const

Seek() sets the position in the data buffer where the Read() and Write() functions (inherited from BPositionIO) begin reading and writing. How the position argument is understood depends on the mode flag. There are three possible modes:

Constant	Description
SEEK_SET	The position passed is an offset from the beginning of allocated memory; in other words, the current position is set to position. For this mode, position should be a positive value.
SEEK_CUR	The position argument is an offset from the current position; the value of the argument is added to the current position.
SEEK_END	The position argument is an offset from the end of the object’s data (not necessarily from the end of allocated memory). Positive values seek beyond the end of the data; negative values seek backwards into the data.

Attempts to seek beyond the end of allocated memory are legal. What Write() is subsequently called, the object updaates its conception of where the data ends to bring the current position within range. If necessary, enough memory will be allocated to accommodate any data added at the current position.

Both Seek() and Position() return the current position as an offset in bytes from the beginning of allocatedd memory.

WriteAt()

virtual ssize_t BMallocIO::WriteAt(off_t position, const void *buffer, size_t numBytes)

Copies numBytes of data from buffer into the object’s data beginning at position.

A successful WriteAt() always returns numBytes. WriteAt() reallocates the buffer (in multiples of the block size) if it needs more room. If the reallocation fails, this function returns B_NO_MEMORY.