Class CCirBuf

class CCirBuf : public CCirBufBase;

Description

A circular buffer containing objects of a type defined by the template parameter.

Derivation

• CBase - Base class for all classes to be instantiated on the heap.

• CCirBufBase - Base class for circular buffers.

• CCirBuf - A circular buffer containing objects of a type defined by the template parameter...

Members

Defined in CCirBuf:

• Add(const T *)Adds a single object to the circular buffer.
• Add(const T *,TInt)Adds multiple objects to the circular buffer.
• CCirBuf()Default C++ constructor.
• Remove(T *)Removes a single object from the circular buffer.
• Remove(T *,TInt)Removes multiple objects from the circular buffer.

Inherited from CBase:

• Delete(CBase *)Deletes the specified object.
• Extension_(TUint,TAny *&,TAny *)Extension function
• operator new(TUint)Allocates the object from the heap and then initialises its contents to binary z...
• operator new(TUint,TAny *)Initialises the object to binary zeroes.
• operator new(TUint,TLeave)Allocates the object from the heap and then initialises its contents to binary z...
• operator new(TUint,TLeave,TUint)Allocates the object from the heap and then initialises its contents to binary z...
• operator new(TUint,TUint)Allocates the object from the heap and then initialises its contents to binary z...

Inherited from CCirBufBase:

• CCirBufBase(TInt)Constructor taking the size of an object within the buffer.
• Count()constGets the current number of objects in this circular buffer.
• DoAdd(const TUint8 *)Implementation function for CCirBuf::Add(const T *)
• DoAdd(const TUint8 *,TInt)Implementation function for CCirBuf::Add(const T *,TInt)
• DoRemove(TUint8 *)Implementation function for CCirBuf::Remove(T *)
• DoRemove(TUint8 *,TInt)Implementation function for CCirBuf::Remove(T *,TInt)
• Length()constGets the maximum capacity of this circular buffer.
• Reset()Empties the buffer.
• SetLengthL(TInt)Sets the maximum capacity of this circular buffer, and resets all of the buffer ...
• iCount
• iHead
• iLength
• iPtr
• iPtrE
• iSize
• iTail

inline CCirBuf();

Description

Default C++ constructor.

The size of each object in the buffer is fixed and is the length of the class passed as the template parameter.

Panic codes

E32USER-CBase 72, if the length of the template class is zero.

inline TInt Add(const T *aPtr);

Description

Adds a single object to the circular buffer.

The object is of type class T and is only added if there is space available.

Parameters

const T *aPtr A pointer to the object of type class T to be added to the circular buffer.

Return value

TInt 1 if the object is successfully added. 0 if the object cannot be added because the circular buffer is full.

Panic codes

E32USER-CBase 74, if a call to CCirBufBase::SetLengthL() has not been made before calling this function.

See also:

• CCirBufBase::SetLengthL(TInt)Sets the maximum capacity of this circular buffer, and resets all of the buffer ...

inline TInt Add(const T *aPtr, TInt aCount);

Description

Adds multiple objects to the circular buffer.

The function attempts to add aCount objects of type class T. The objects are only added if there is space available.

Parameters

const T *aPtr A pointer to a set of contiguous objects of type class T to be added to the circular buffer. TInt aCount The number of objects to be added to the circular buffer.

Return value

TInt The number of objects successfully added to the buffer. This value may be less than the number requested and can range from 0 to aCount.

Panic codes

E32USER-CBase 74, if a call to CCirBufBase::SetLengthL() has not been made before calling this function. E32USER-CBase 75, if aCount is not a positive value.

See also:

• CCirBufBase::SetLengthL(TInt)Sets the maximum capacity of this circular buffer, and resets all of the buffer ...

inline TInt Remove(T *aPtr);

Description

Removes a single object from the circular buffer.

An object can only be removed if there are objects in the buffer.

A binary copy of the object is made to aPtr.

Parameters

T *aPtr A pointer to an object of type class T supplied by the caller.

Return value

TInt 1 if an object is successfully removed. 0 if an object cannot be removed because the circular buffer is empty.

inline TInt Remove(T *aPtr, TInt aCount);

Description

Removes multiple objects from the circular buffer.

The function attempts to remove aCount objects of type class T. Objects can only be removed if there are objects in the buffer

A binary copy of the objects is made to aPtr.

Parameters

T *aPtr A pointer to contiguous memory able to hold aCount class T objects, supplied by the caller. TInt aCount The number of objects to be removed from the circular buffer.

Return value

TInt The number of objects successfully removed from the buffer. This value may be less than the number requested, and can range from 0 to aCount.

Panic codes

E32USER-CBase 76, if aCount is not a positive value.