rtxMemBuf.h

Go to the documentation of this file.
00001 /*
00002  * Copyright (c) 2003-2009 Objective Systems, Inc.
00003  *
00004  * This software is furnished under a license and may be used and copied
00005  * only in accordance with the terms of such license and with the
00006  * inclusion of the above copyright notice. This software or any other
00007  * copies thereof may not be provided or otherwise made available to any
00008  * other person. No title to and ownership of the software is hereby
00009  * transferred.
00010  *
00011  * The information in this software is subject to change without notice
00012  * and should not be construed as a commitment by Objective Systems, Inc.
00013  *
00014  * PROPRIETARY NOTICE
00015  *
00016  * This software is an unpublished work subject to a confidentiality agreement
00017  * and is protected by copyright and trade secret law.  Unauthorized copying,
00018  * redistribution or other use of this work is prohibited.
00019  *
00020  * The above notice of copyright on this source code product does not indicate
00021  * any actual or intended publication of such source code.
00022  *
00023  *****************************************************************************/
00024 
00041 /* memory buffer */
00042 
00043 #ifndef _RTXMEMBUF_H_
00044 #define _RTXMEMBUF_H_
00045 
00046 #include "rtxsrc/rtxContext.h"
00047 
00048 typedef struct OSRTMEMBUF {
00049    OSCTXT*      pctxt;
00050    OSUINT32     segsize;        /* segment size                     */
00051    OSUINT32     startidx;       /* start index of useful info       */
00052    OSUINT32     usedcnt;        /* used byte count                  */
00053    OSUINT32     bufsize;        /* buffer size                      */
00054    OSUINT32     bitOffset;      /* bit offset                       */
00055    OSUINT32     userState;      /* user state - any value, 0 is initial */
00056    OSOCTET*     buffer;         /* memory buffer                    */
00057    OSBOOL       isDynamic;      /* is buffer allocated dynamically? */
00058    OSBOOL       isExpandable;   /* is buffer expandable?            */
00059 } OSRTMEMBUF;
00060 
00061 #define OSMBDFLTSEGSIZE 1024
00062 
00063 #define OSMEMBUFPTR(pmb)    ((pmb)->buffer + (pmb)->startidx)
00064 #define OSMEMBUFENDPTR(pmb) ((pmb)->buffer + (pmb)->startidx + (pmb)->usedcnt)
00065 #define OSMEMBUFUSEDSIZE(pmb) ((size_t)(pmb)->usedcnt)
00066 
00067 #define OSMBAPPENDSTR(pmb,str) \
00068 rtxMemBufAppend(pmb,(OSOCTET*)str,OSCRTLSTRLEN(str))
00069 
00070 #define OSMBAPPENDUTF8(pmb,str) \
00071 rtxMemBufAppend(pmb,(OSOCTET*)str,rtxUTF8LenBytes(str))
00072 
00073 #ifdef __cplusplus
00074 extern "C" {
00075 #endif
00076 
00077 /* Memory buffer functions */
00078 
00093 EXTERNRT int rtxMemBufAppend 
00094 (OSRTMEMBUF* pMemBuf, const OSOCTET* pdata, size_t nbytes);
00095 
00110 EXTERNRT int rtxMemBufCut (OSRTMEMBUF* pMemBuf, size_t fromOffset, size_t nbytes);
00111 
00119 EXTERNRT void rtxMemBufFree (OSRTMEMBUF* pMemBuf);
00120 
00129 EXTERNRT OSOCTET* rtxMemBufGetData (OSRTMEMBUF* pMemBuf, int* length);
00130 
00137 EXTERNRT int rtxMemBufGetDataLen (OSRTMEMBUF* pMemBuf); 
00138 
00151 EXTERNRT void rtxMemBufInit (OSCTXT* pCtxt, OSRTMEMBUF* pMemBuf, 
00152                               size_t segsize);
00153 
00171 EXTERNRT void rtxMemBufInitBuffer (OSCTXT* pCtxt, OSRTMEMBUF* pMemBuf, 
00172                                     OSOCTET* buf, size_t bufsize, 
00173                                     size_t segsize);
00174 
00184 EXTERNRT int rtxMemBufPreAllocate (OSRTMEMBUF* pMemBuf, size_t nbytes);
00185 
00192 EXTERNRT void rtxMemBufReset (OSRTMEMBUF* pMemBuf);
00193 
00209 EXTERNRT int rtxMemBufSet (OSRTMEMBUF* pMemBuf, OSOCTET value, size_t nbytes);
00210 
00222 EXTERNRT OSBOOL rtxMemBufSetExpandable 
00223 (OSRTMEMBUF* pMemBuf, OSBOOL isExpandable);
00224 
00233 EXTERNRT int rtxMemBufTrimW (OSRTMEMBUF* pMemBuf); 
00234 
00238 #ifdef __cplusplus
00239 }
00240 #endif
00241 
00242 #endif