mstring.h

Go to the documentation of this file.

#ifndef MSTRING_H
#define MSTRING_H

#ifndef CTLSTRING_H
#error This should be included from "ctl/ctlstring.h"
#endif

#define ctl_mstring(tchar,handler )                         ppConcat4(ctl_mstring_,tchar,_,handler)

#define ctl_mstring_(tchar,handler,function )               ppConcat3(ctl_mstring(tchar,handler),_,function)



#define ctl_mstring_xgrow(tchar,handler, xgrow )            ppConcat3(ctl_mstring_,handler,_xgrow)(tchar, xgrow )
#define ctl_mstring_grow_xgrow(tchar, xgrow)                xgrow
#define ctl_mstring_fixed_xgrow(tchar, xgrow)

#define ctl_mstring_xfixed(tchar,handler, xfixed )          ppConcat3(ctl_mstring_,handler,_xfixed)(tchar, xfixed )
#define ctl_mstring_grow_xfixed(tchar, xfixed)
#define ctl_mstring_fixed_xfixed(tchar, xfixed)             xfixed

#define ctl_mstring_cond(tchar,handler, xgrow, xfixed )     ppConcat3(ctl_mstring_,handler,_cond)(tchar, xgrow, xfixed )
#define ctl_mstring_grow_cond(tchar, xgrow, xfixed)         xgrow
#define ctl_mstring_fixed_cond(tchar, xgrow, xfixed)        xfixed

#define ctldecl_ctl_mstring(tchar,handler ) \
\
typedef struct ctl_mstring(tchar,handler ) \
{\
    tchar*          begin;  /* Beginning of string; always at least valid to read */\
    tchar*          end;    /* End of written string; always points at a NUL character, always [begin >= parse >= end] */\
    tchar*          endBuff;/* End of buffer available for string - begin+length; never really a valid location to read or write, but it's reserved by every init for a terminating NUL */\
} ctl_mstring(tchar,handler );\
\
ctl_mstring_xgrow(tchar,handler, extern const tchar ctl_mstring_(tchar,handler,0)[1]; ) /* Needed for empty/growable string */\
\
void ctl_mstring_(tchar,handler, grow )( ctl_mstring(tchar,handler)* self, size_t addLen );\
void ctl_mstring_(tchar,handler, fill )( ctl_mstring(tchar,handler)* self, tchar fillVal, size_t maxLen );\
void ctl_mstring_(tchar,handler, filltab )( ctl_mstring(tchar,handler)* self, tchar fillVal, size_t tabPos );\
void ctl_mstring_(tchar,handler, putint32 )( ctl_mstring(tchar,handler)* self, int32 value );\
void ctl_mstring_(tchar,handler, putuint32 )( ctl_mstring(tchar,handler)* self, uint32 value );\
void ctl_mstring_(tchar,handler, putint64 )( ctl_mstring(tchar,handler)* self, int64 value );\
void ctl_mstring_(tchar,handler, putuint64 )( ctl_mstring(tchar,handler)* self, uint64 value );\
void ctl_mstring_(tchar,handler, putfloat64 )( ctl_mstring(tchar,handler)* self, float64 value );\
void ctl_mstring_(tchar,handler, putxuint32 )( ctl_mstring(tchar,handler)* self, uint32 value, size_t places );\
void ctl_mstring_(tchar,handler, putxuint64 )( ctl_mstring(tchar,handler)* self, uint64 value, size_t places );\
void ctl_mstring_(tchar,handler, putenum )( ctl_mstring(tchar,handler)* self, int value, const tchar* const* const szzList, int max, const tchar* szUndefined );\
void ctl_mstring_(tchar,handler, strncat )( ctl_mstring(tchar,handler)* self, const tchar* sz, size_t maxLen );\
void ctl_mstring_(tchar,handler, strncpy )( ctl_mstring(tchar,handler)* self, const tchar* sz, size_t maxLen );\
void ctl_mstring_(tchar,handler, strninsert )( ctl_mstring(tchar,handler)* self, size_t position, const tchar* sz, size_t max );\
void ctl_mstring_(tchar,handler, vsprintf )( ctl_mstring(tchar,handler)* self, const tchar* fmt, va_list args );\
void ctl_mstring_(tchar,handler, sprintf )( ctl_mstring(tchar,handler)* self, const tchar* fmt, ... );\
void ctl_mstring_(tchar,handler, makeClabel )( ctl_mstring(tchar,handler)* self );\
void ctl_mstring_(tchar,handler, truncate )( ctl_mstring(tchar,handler)* self, size_t newsize );\
int ctl_mstring_(tchar,handler, compare )( const ctl_mstring(tchar,handler)* p1, const ctl_mstring(tchar,handler)* p2 );\
int ctl_mstring_(tchar,handler, rcompare )( const ctl_mstring(tchar,handler)* p1, const ctl_mstring(tchar,handler)* p2 );\
int ctl_mstring_(tchar,handler, strncmp )( const ctl_mstring(tchar,handler)* p1, const tchar* p2, size_t lenp2 );\
int ctl_mstring_(tchar,handler, strnicmp )( const ctl_mstring(tchar,handler)* p1, const tchar* p2, size_t lenp2 );\


/* Declare functions that grow string when it runs out */
ctldecl_ctl_mstring(char,grow)
ctldecl_ctl_mstring(wchar_t,grow)

/* Declare functions that abort output when it's too big */
ctldecl_ctl_mstring(char,fixed)
ctldecl_ctl_mstring(wchar_t,fixed)

#endif /* MSTRING_H */