Memory Buffer Management FunctionsMemory buffer management functions handle the allocation, expansion, and deallocation of dynamic memory buffers used by some encode/decode functions.
More...
|
Classes |
| struct | OSMemBuf |
Defines |
|
#define | OSMBDFLTSEGSIZE 1024 |
|
#define | OSMEMBUFPTR(pmb) ((pmb)->buffer + (pmb)->startidx) |
|
#define | OSMEMBUFENDPTR(pmb) ((pmb)->buffer + (pmb)->startidx + (pmb)->usedcnt) |
|
#define | OSMEMBUFUSEDSIZE(pmb) ((size_t)(pmb)->usedcnt) |
|
#define | OSMBAPPENDSTR(pmb, str) rtxMemBufAppend(pmb,(OSOCTET*)str,strlen(str)) |
|
#define | OSMBAPPENDUTF8(pmb, str) rtxMemBufAppend(pmb,(OSOCTET*)str,rtxUTF8LenBytes(str)) |
Functions |
| int | rtxMemBufAppend (OSMemBuf *pMemBuf, const OSOCTET *pdata, size_t nbytes) |
| | This function appends the data to the end of a memory buffer.
|
| int | rtxMemBufCut (OSMemBuf *pMemBuf, size_t fromOffset, size_t nbytes) |
| | This function cuts off the part of memory buffer.
|
| void | rtxMemBufFree (OSMemBuf *pMemBuf) |
| | This function frees the memory buffer.
|
| OSOCTET * | rtxMemBufGetData (OSMemBuf *pMemBuf, int *length) |
| | This function returns the pointer to the used part of a memory buffer.
|
| int | rtxMemBufGetDataLen (OSMemBuf *pMemBuf) |
| | This function returns the length of the used part of a memory buffer.
|
| void | rtxMemBufInit (OSCTXT *pCtxt, OSMemBuf *pMemBuf, size_t segsize) |
| | This function initializes a memory buffer structure.
|
| void | rtxMemBufInitBuffer (OSCTXT *pCtxt, OSMemBuf *pMemBuf, OSOCTET *buf, size_t bufsize, size_t segsize) |
| | This function assigns a static buffer to the memory buffer structure.
|
| int | rtxMemBufPreAllocate (OSMemBuf *pMemBuf, size_t nbytes) |
| | This function allocates a buffer with a predetermined amount of space.
|
| void | rtxMemBufReset (OSMemBuf *pMemBuf) |
| | This function resets the memory buffer structure.
|
| int | rtxMemBufSet (OSMemBuf *pMemBuf, OSOCTET value, size_t nbytes) |
| | This function sets part of a memory buffer to a specified octet value.
|
| int | rtxMemBufTrimW (OSMemBuf *pMemBuf) |
| | This function trims white space of the memory buffer.
|
Detailed Description
Memory buffer management functions handle the allocation, expansion, and deallocation of dynamic memory buffers used by some encode/decode functions.
Dynamic memory buffers are buffers that can grow or shrink to hold variable sized amounts of data. This group of functions allows data to be appended to buffers, to be set within buffers, and to be retrieved from buffers. Currently, these functions are used within the generated SAX decode routines to collect data as it is parsed by an XML parser.
Function Documentation
| int rtxMemBufAppend |
( |
OSMemBuf * |
pMemBuf, |
|
|
const OSOCTET * |
pdata, |
|
|
size_t |
nbytes |
|
) |
|
|
|
|
This function appends the data to the end of a memory buffer.
If the buffer was dynamic and full then the buffer will be reallocated. If it is static (the static buffer was assigned by a call to rtxMemBufInitBuffer) or it is empty (no memory previously allocated) then a new buffer will be allocated.
- Parameters:
-
| pMemBuf | A pointer to a memory buffer structure. |
| pdata | The pointer to the buffer to be appended. The data will be copied at the end of the memory buffer. |
| nbytes | The number of bytes to be copied from pData. |
- Returns:
- Completion status of operation:
- 0 = success,
- negative return value is error.
|
| int rtxMemBufCut |
( |
OSMemBuf * |
pMemBuf, |
|
|
size_t |
fromOffset, |
|
|
size_t |
nbytes |
|
) |
|
|
|
|
This function cuts off the part of memory buffer.
The beginning of the cutting area is specified by offset "fromOffset" and the length is specified by "nbytes". All data in this part will be lost. The data from the offset "fromOffset + nbytes" will be moved to "fromOffset" offset.
- Parameters:
-
| pMemBuf | A pointer to a memory buffer structure. |
| fromOffset | The offset of the beginning part, being cut off. |
| nbytes | The number of bytes to be cut off from the memory buffer. |
- Returns:
- Completion status of operation:
- 0 = success,
- negative return value is error.
|
| void rtxMemBufFree |
( |
OSMemBuf * |
pMemBuf |
) |
|
|
|
|
This function frees the memory buffer.
If memory was allocated then it will be freed. Do not use the memory buffer structure after this function is called.
- Parameters:
-
| pMemBuf | A pointer to a memory buffer structure. |
|
|
|
This function returns the pointer to the used part of a memory buffer.
- Parameters:
-
| pMemBuf | A pointer to a memory buffer structure. |
| length | The pointer to the length of the used part of the memory buffer. |
- Returns:
- The pointer to the used part of the memory buffer.
|
| int rtxMemBufGetDataLen |
( |
OSMemBuf * |
pMemBuf |
) |
|
|
|
|
This function returns the length of the used part of a memory buffer.
- Parameters:
-
| pMemBuf | A pointer to a memory buffer structure. |
- Returns:
- The length of the used part of the buffer.
|
| void rtxMemBufInit |
( |
OSCTXT * |
pCtxt, |
|
|
OSMemBuf * |
pMemBuf, |
|
|
size_t |
segsize |
|
) |
|
|
|
|
This function initializes a memory buffer structure.
It does not allocate memory; it sets the fields of the structure to the proper states. This function must be called before any operations with the memory buffer.
- Parameters:
-
| pCtxt | A provides a storage area for the function to store all working variables that must be maintained between function calls. |
| pMemBuf | A pointer to the initialized memory buffer structure. |
| segsize | The number of bytes in which the memory buffer will be expanded incase it is full. |
|
| void rtxMemBufInitBuffer |
( |
OSCTXT * |
pCtxt, |
|
|
OSMemBuf * |
pMemBuf, |
|
|
OSOCTET * |
buf, |
|
|
size_t |
bufsize, |
|
|
size_t |
segsize |
|
) |
|
|
|
|
This function assigns a static buffer to the memory buffer structure.
It does not allocate memory; it sets the pointer to the passed buffer. If additional memory is required (for example, additional data is appended to the buffer using rtxMemBufAppend), a dynamic buffer will be allocated and all data copied to the new buffer.
- Parameters:
-
| pCtxt | A pointer to a context structure. This provides a storage area for the function t store all working variables that must be maintained between function calls. |
| pMemBuf | A pointer to a memory buffer structure. |
| buf | A pointer to the buffer to be assigned. |
| bufsize | The size of the buffer. |
| segsize | The number of bytes on which the memory buffer will be expanded in case it is full. |
|
| int rtxMemBufPreAllocate |
( |
OSMemBuf * |
pMemBuf, |
|
|
size_t |
nbytes |
|
) |
|
|
|
|
This function allocates a buffer with a predetermined amount of space.
- Parameters:
-
| pMemBuf | A pointer to a memory buffer structure. |
| nbytes | The number of bytes to be copied from pData. |
- Returns:
- Completion status of operation:
- 0 = success,
- negative return value is error.
|
| void rtxMemBufReset |
( |
OSMemBuf * |
pMemBuf |
) |
|
|
|
|
This function resets the memory buffer structure.
It does not free memory, just sets the pointer to the beginning and the used length to zero.
- Parameters:
-
| pMemBuf | A pointer to a memory buffer structure. |
|
|
|
This function sets part of a memory buffer to a specified octet value.
The filling is started from the end of the memory buffer. If the buffer is dynamic and full, then the buffer will be reallocated. If it is static (a static buffer was assigned by a call to rtxMemBufInitBuffer) or it is empty (no memory previously was allocated) then a new buffer will be allocated.
- Parameters:
-
| pMemBuf | A pointer to a memory buffer structure. |
| value | The pointer to the buffer to be appended. The data will be copied at the end of the memory buffer. |
| nbytes | The number of bytes to be copied from pData. |
- Returns:
- Completion status of operation:
- 0 = success,
- negative return value is error.
|
| int rtxMemBufTrimW |
( |
OSMemBuf * |
pMemBuf |
) |
|
|
|
|
This function trims white space of the memory buffer.
- Parameters:
-
| pMemBuf | A pointer to a memory buffer structure. |
- Returns:
- Completion status of operation:
- 0 = success,
- negative return value is error.
|
|
