Multi-Hackers / SocketModem

A library for talking to Multi-Tech's Cellular SocketModem Devices.

Dependents:   M2X_dev axeda_wrapper_dev MTS_M2x_Example1 MTS_Cellular_Connect_Example ... more

Embed: (wiki syntax)

« Back to documentation index

MTSCircularBuffer Class Reference
Public Member Functions

MTSCircularBuffer Class Reference

This class provides a circular byte buffer meant for temporary storage during IO transactions. More...

#include <MTSCircularBuffer.h>

Public Member Functions

 MTSCircularBuffer (int bufferSize)
 Creates an MTSCircularBuffer object with the specified static size.
 ~MTSCircularBuffer ()
 Destructs an MTSCircularBuffer object and frees all related resources.
int read (char *data, int length)
 This method enables bulk reads from the buffer.
int read (char &data)
 This method reads a single byte from the buffer.
int write (const char *data, int length)
 This method enables bulk writes to the buffer.
int write (char data)
 This method writes a signle byte as a char to the buffer.
template<typename T >
void attach (T *tptr, void(T::*mptr)(void), int threshold, Vars::RelationalOperator op)
 This method is used to setup a callback funtion when the buffer reaches a certain threshold.
void attach (void(*fptr)(void), int threshold, Vars::RelationalOperator op)
 This method is used to setup a callback funtion when the buffer reaches a certain threshold.
int capacity ()
 This method returns the size of the storage space currently allocated for the buffer.
int remaining ()
 This method returns the amount of space left for writing.
int size ()
 This method returns the number of bytes available for reading.
bool isEmpty ()
 This method returns whether the buffer is empty.
bool isFull ()
 This method returns whether the buffer is full.
void clear ()
 This method clears the buffer.

Detailed Description

This class provides a circular byte buffer meant for temporary storage during IO transactions.

It contains many of the common methods you would expect from a circular buffer like read, write, and various methods for checking the size or status. It should be noted that this class does not include any special code for thread safety like a lock. In most cases this is not problematic, but is something to be aware of.

Definition at line 33 of file MTSCircularBuffer.h.

Constructor & Destructor Documentation

MTSCircularBuffer ( int  bufferSize )

Creates an MTSCircularBuffer object with the specified static size.

bufferSize size of the buffer in bytes.

Definition at line 21 of file MTSCircularBuffer.cpp.

~MTSCircularBuffer (  )

Destructs an MTSCircularBuffer object and frees all related resources.

Definition at line 26 of file MTSCircularBuffer.cpp.

Member Function Documentation

void attach ( T *  tptr,
void(T::*)(void)  mptr,
int  threshold,
Vars::RelationalOperator  op 
)

This method is used to setup a callback funtion when the buffer reaches a certain threshold.

The threshold condition is checked after every read and write call is completed. The condition is made up of both a threshold value and operator. An example that would trigger a callback is if the threshold was 10, the operator GREATER, and there were 12 bytes added to an empty buffer.

Parameters:
tptra pointer to the object to be called when the condition is met.
mptra pointer to the function within the object to be called when the condition is met.
thresholdthe value in bytes to be used as part of the condition.
opthe operator to be used in conjunction with the threshold as part of the condition.

Definition at line 96 of file MTSCircularBuffer.h.

void attach ( void(*)(void)  fptr,
int  threshold,
Vars::RelationalOperator  op 
)

This method is used to setup a callback funtion when the buffer reaches a certain threshold.

The threshold condition is checked after every read and write call is completed. The condition is made up of both a threshold value and operator. An example that would trigger a callback is if the threshold was 10, the operator GREATER, and there were 12 bytes added to an empty buffer.

Parameters:
fptra pointer to the static function to be called when the condition is met.
thresholdthe value in bytes to be used as part of the condition.
opthe operator to be used in conjunction with the threshold as part of the condition.

Definition at line 116 of file MTSCircularBuffer.h.

int capacity (  )

This method returns the size of the storage space currently allocated for the buffer.

This value is equivalent to the one passed into the constructor. This value is equal or greater than the size() of the buffer.

Returns:
the allocated size of the buffer in bytes.

Definition at line 31 of file MTSCircularBuffer.cpp.

void clear (  )

This method clears the buffer.

This is done through setting the internal read and write indexes to the same value and is therefore not an expensive operation.

Definition at line 120 of file MTSCircularBuffer.cpp.

bool isEmpty (  )

This method returns whether the buffer is empty.

Returns:
true if empty, otherwise false.

Definition at line 111 of file MTSCircularBuffer.cpp.

bool isFull (  )

This method returns whether the buffer is full.

Returns:
true if full, otherwise false.

Definition at line 102 of file MTSCircularBuffer.cpp.

int read ( char &  data )

This method reads a single byte from the buffer.

Parameters:
datachar where the read byte will be stored.
Returns:
1 if byte is read or 0 if no bytes available.

Definition at line 50 of file MTSCircularBuffer.cpp.

int read ( char *  data,
int  length 
)

This method enables bulk reads from the buffer.

If more data is requested then available it simply returns all remaining data within the buffer.

Parameters:
datathe buffer where data read will be added to.
lengththe amount of data in bytes to be read into the buffer.
Returns:
the total number of bytes that were read.

Definition at line 36 of file MTSCircularBuffer.cpp.

int remaining (  )

This method returns the amount of space left for writing.

Returns:
numbers of unused bytes in buffer.

Definition at line 92 of file MTSCircularBuffer.cpp.

int size (  )

This method returns the number of bytes available for reading.

Returns:
number of bytes currently in buffer.

Definition at line 97 of file MTSCircularBuffer.cpp.

int write ( const char *  data,
int  length 
)

This method enables bulk writes to the buffer.

If more data is requested to be written then space available the method writes as much data as possible and returns the actual amount written.

Parameters:
datathe byte array to be written.
lengththe length of data to be written from the data paramter.
Returns:
the number of bytes written to the buffer, which is 0 if the buffer is full.

Definition at line 64 of file MTSCircularBuffer.cpp.

int write ( char  data )

This method writes a signle byte as a char to the buffer.

Parameters:
datathe byte to be written as a char.
Returns:
1 if the byte was written or 0 if the buffer was full.

Definition at line 78 of file MTSCircularBuffer.cpp.

Generated on Tue Jul 12 2022 21:46:23 by  doxygen 1.7.2