NRAOCASA: casa::DynBuffer Class Reference

DynBuffer allows one to store data in dynamically allocated buffers. When a buffer is full, an additional buffer can be allocated and "linked" to the existing one; so, the data may not be stored contiguously You can loop through all the linked buffers and get their individual addresses and sizes, so that you can access the data.

Example

    uInt nrOfValues, nrNeeded, nrAvailable;// nr of data values
    float* pData = floatarr;               // ptr to data to be handled
    Char* pBuffer;                         // ptr to buffer
   
    DynBuffer buffer;                      // create buffer
    buffer.allocstart();                   // prepare for storing
    nrNeeded = nrOfValues;                 // nr of values to store
    // copy data into dynamic buffer
    while (nrNeeded > 0) {
        nrAvailable = buffer.alloc (nrNeeded, sizeof(float), pBuffer);
                                           // get buffer space:
                                           // room for nrAvailable values
        memcpy (pBuffer, pData, nrAvailable*sizeof(float));
                                           // copy that many data values
        nrNeeded -= nrAvailable;           // how much more needed?
        pData += nrAvailable;              // pointer to as yet unstored data
    }
    // Maybe store more values
        .
        .
    // Retrieve all the data values from the buffers and write them
    buffer.nextstart();                    // goto buffer start
    while (buffer.next (nrAvailable, pBuffer)) {
                                           // get next buffer
        write (fd, nrAvailable, pBuffer);  // write data from that buffer
    }

Motivation

This class is developed as an intermediate buffer for class AipsIO , but it may serve other purposes as well.

Definition at line 92 of file DynBuffer.h.


Public Member Functions
	DynBuffer (uInt nrOfBytes=4096)
	Allocate a first buffer of the specified number of bytes (default 4096).
	~DynBuffer ()
	Remove the whole buffer, i.e.
void	allocstart ()
	Prepare for storing data (re-initialize the buffer).
uInt	alloc (uInt nrOfValues, uInt valueSize, Char *&ptr)
	Allocate buffer space for `nrOfValues` values of size `valueSize` bytes, and return the pointer `ptr` to the buffer and the number of values that fit in the buffer.
void	remove (uInt nrOfBuffer=1)
	Remove buffer `nrOfBuffer` and the buffers appended to it, and re-initialize the current buffer.
void	nextstart ()
	Prepare for data retrieval (set up for looping through the buffers).
Bool	next (uInt &usedLength, Char *&ptr)
	Get the pointer to the next buffer and its used length in bytes.
Private Member Functions
uInt	newbuf (uInt nrOfValues, uInt valueSize)
	Get the next buffer for storing `nrOfValues` values of size `valueSize` bytes, and return the number of values that can be stored in the free space of that buffer (maybe less than `nrOfValues`).
Private Attributes
uInt	bufsz_p
	size of 1st buffer and min.
Int	nextbuf_p
	buffernr for next function
Int	curbuf_p
	current buffernr
Int	nrbuf_p
	nr of buffers allocated
Int	maxnrbuf_p
	size of Blocks
Block< uInt >	uselen_p
	used length per buffer
Block< uInt >	totlen_p
	total length per buffer
PtrBlock< Char * >	bufptr_p
	pointer to buffer
uInt	curuselen_p
	used length of current buffer
uInt	curtotlen_p
	total length of current buffer
Char *	curbufptr_p
	pointer to current buffer

Constructor & Destructor Documentation

casa::DynBuffer::DynBuffer ( uInt nrOfBytes = 4096 )

Allocate a first buffer of the specified number of bytes (default 4096).

When the allocation fails, an exception is thrown.

Thrown Exceptions

AllocError

casa::DynBuffer::~DynBuffer ( )

Remove the whole buffer, i.e.

the first buffer and all the buffers appended to it.

Member Function Documentation

void casa::DynBuffer::allocstart ( )

Prepare for storing data (re-initialize the buffer).

uInt casa::DynBuffer::alloc	(	uInt	nrOfValues,
		uInt	valueSize,
		Char *&	ptr
	)			`[inline]`

Allocate buffer space for nrOfValues values of size valueSize bytes, and return the pointer ptr to the buffer and the number of values that fit in the buffer.

When not all values fit in the current buffer, new buffer space is added (probably non-contiguous). If that allocation fails an exception is thrown.

Thrown Exceptions

AllocError

Definition at line 187 of file DynBuffer.h.

References curbufptr_p, curtotlen_p, curuselen_p, and newbuf().

void casa::DynBuffer::remove ( uInt nrOfBuffer = 1 )

Remove buffer nrOfBuffer and the buffers appended to it, and re-initialize the current buffer.

By default we keep the first buffer (i.e. the one numbered 0).

The idea is that you may want to free intermediate storage space taken up by data that you no longer need, and that the first buffer is often big enough to hold further data. So, you only remove the first buffer in special cases.

void casa::DynBuffer::nextstart ( )

Prepare for data retrieval (set up for looping through the buffers).

Bool casa::DynBuffer::next	(	uInt &	usedLength,
		Char *&	ptr
	)

Get the pointer to the next buffer and its used length in bytes.

The function returns a False value if there are no more buffers.

uInt casa::DynBuffer::newbuf	(	uInt	nrOfValues,
		uInt	valueSize
	)			`[private]`

Get the next buffer for storing nrOfValues values of size valueSize bytes, and return the number of values that can be stored in the free space of that buffer (maybe less than nrOfValues).

The new current buffer can be the present one (if it has free space), the next buffer already allocated (if there is one), or a newly allocated and linked-in buffer. If, in the last case, the allocation fails an exception is thrown.