SWBuf Class Reference

#include <swbuf.h>

Collaboration diagram for SWBuf:

Public Member Functions
SWBuf &	append (const char *str, long max=-1)
SWBuf &	append (const SWBuf &str, long max=-1)
SWBuf &	append (char ch)
SWBuf &	append (const unsigned char ch)
SWBuf &	append (wchar_t wch)
SWBuf &	appendFormatted (const char *format,...)
const char *	c_str () const
char &	charAt (unsigned long pos)
const char &	charAt (unsigned long pos) const
char &	charAtGuarded (unsigned long pos)
int	compare (const SWBuf &other) const
int	compare (const char *other) const
bool	endsWith (const SWBuf &postfix) const
bool	endsWith (const char *postfix) const
char	getFillByte ()
char *	getRawData ()
long	indexOf (const SWBuf &needle) const
void	insert (unsigned long pos, const char *str, unsigned long start=0, signed long max=-1)
void	insert (unsigned long pos, const SWBuf &str, unsigned long start=0, signed long max=-1)
void	insert (unsigned long pos, char c)
unsigned long	length () const
	operator const char * () const
bool	operator!= (const SWBuf &other) const
bool	operator!= (const char *other) const
SWBuf	operator+ (const SWBuf &other) const
SWBuf	operator+ (char ch) const
SWBuf &	operator+= (const char *str)
SWBuf &	operator+= (char ch)
SWBuf &	operator-- (int)
SWBuf &	operator-= (unsigned long len)
bool	operator< (const SWBuf &other) const
bool	operator< (const char *other) const
SWBuf &	operator<< (unsigned long n)
bool	operator<= (const SWBuf &other) const
bool	operator<= (const char *other) const
SWBuf &	operator= (const char *newVal)
SWBuf &	operator= (const SWBuf &other)
bool	operator== (const SWBuf &other) const
bool	operator== (const char *other) const
bool	operator> (const SWBuf &other) const
bool	operator> (const char *other) const
bool	operator>= (const SWBuf &other) const
bool	operator>= (const char *other) const
SWBuf &	operator>> (unsigned long n)
char &	operator[] (unsigned long pos)
char &	operator[] (long pos)
char &	operator[] (unsigned int pos)
char &	operator[] (int pos)
const char &	operator[] (unsigned long pos) const
const char &	operator[] (long pos) const
const char &	operator[] (unsigned int pos) const
const char &	operator[] (int pos) const
SWBuf &	replaceBytes (const char *targets, char newByte)
void	resize (unsigned long len)
void	set (const SWBuf &newVal)
void	set (const char *newVal, unsigned long maxSize=0)
void	setFillByte (char ch)
SWBuf &	setFormatted (const char *format,...)
SWBuf &	setFormattedVA (const char *format, va_list argptr)
void	setSize (unsigned long len)
unsigned long	size () const
void	size (unsigned long newSize)
bool	startsWith (const SWBuf &prefix) const
bool	startsWith (const char *prefix) const
const char *	stripPrefix (char separator, bool endOfStringAsSeparator=false)
	SWBuf ()
	SWBuf (const char *initVal, unsigned long initSize=0)
	SWBuf (const SWBuf &other, unsigned long initSize=0)
	SWBuf (char initVal, unsigned long initSize=0)
SWBuf &	toLower ()
SWBuf &	toUpper ()
SWBuf &	trim ()
SWBuf &	trimEnd ()
SWBuf &	trimStart ()
	~SWBuf ()

Static Public Attributes
static char *	nullStr = (char *)""

Private Member Functions
void	assureMore (size_t pastEnd)
void	assureSize (size_t checkSize)
void	init (size_t initSize)

Private Attributes
unsigned long	allocSize
char *	buf
char *	end
char *	endAlloc
char	fillByte

Detailed Description

This class is used as a transport and utility for data buffers.

Warning

This class does not perform pointer validity checks (for speed reasons). Therefore, never try to pass an invalid string (const char* 0) as an argument- it will crash your program. You need to perform the checks yourself!

Definition at line 47 of file swbuf.h.

Constructor & Destructor Documentation

SWBuf::SWBuf ( )

inline

Definition at line 93 of file swbuf.h.

                   {
        init(0);
    }

SWBuf::SWBuf ( const char *  initVal, unsigned long  initSize = 0  )

inline

Definition at line 102 of file swbuf.h.

                                                                  {
        init(initSize);
        if (initVal)
            set(initVal, initSize);
    }

SWBuf::SWBuf ( const SWBuf &  other, unsigned long  initSize = 0  )

inline

Definition at line 113 of file swbuf.h.

                                                                 {
        init(initSize);
        set(other);
    }

SWBuf::SWBuf ( char  initVal, unsigned long  initSize = 0  )

inline

Definition at line 123 of file swbuf.h.

                                                           {
        init(initSize+1);
        *buf = initVal;
        end = buf+1;
        *end = 0;
    }

SWBuf::~SWBuf ( )

inline

Definition at line 135 of file swbuf.h.

                    {
        if ((buf) && (buf != nullStr))
            free(buf);
    }

Member Function Documentation

SWBuf& SWBuf::append ( const char *  str, long  max = -1  )

inline

SWBuf::append - appends a value to the current value of this SWBuf. If the allocated memory is not enough, it will be resized accordingly.

Parameters

str	Append this.
max	Append only max chars.

Definition at line 274 of file swbuf.h.

                                                         {
    //  if (!str) //A null string was passed
    //      return;
        if (max < 0)
            max = strlen(str);
        assureMore(max+1);
        for (;((max)&&(*str));max--)
            *end++ = *str++;
        *end = 0;
        return *this;
    }

SWBuf& SWBuf::append ( const SWBuf &  str, long  max = -1  )

inline

SWBuf::append - appends a value to the current value of this SWBuf If the allocated memory is not enough, it will be resized accordingly.

Parameters

str	Append this.
max	Append only max chars.

Definition at line 292 of file swbuf.h.

{ return append(str.c_str(), max); }

SWBuf& SWBuf::append ( char  ch )

inline

SWBuf::append - appends a value to the current value of this SWBuf If the allocated memory is not enough, it will be resized accordingly.

Parameters

ch	Append this.

Definition at line 299 of file swbuf.h.

                                  {
        assureMore(1);
        *end++ = ch;
        *end = 0;
        return *this;
    }

SWBuf& SWBuf::append ( const unsigned char  ch )

inline

Definition at line 305 of file swbuf.h.

                                                 {
        assureMore(1);
        *end++ = ch;
        *end = 0;
        return *this;
    }

SWBuf& SWBuf::append ( wchar_t  wch )

inline

SWBuf::append - appends a wide character value to the current value of this SWBuf If the allocated memory is not enough, it will be resized accordingly. NOTE: This is dangerous, as wchar_t is currently different sizes on different platforms (stupid windoze; stupid c++ spec for not mandating 4byte).

Parameters

wch	Append this.

Definition at line 319 of file swbuf.h.

                                      {
        assureMore(sizeof(wchar_t)*2);
        for (unsigned int i = 0; i < sizeof(wchar_t); i++) *end++ = ((char *)&wch)[i];
        for (unsigned int i = 0; i < sizeof(wchar_t); i++) end[i] = 0;
        return *this;
    }

SWBuf & SWBuf::appendFormatted	(	const char *	format,
			...
	)

SWBuf::appendFormatted - appends formatted strings to the current value of this SWBuf.

Warning

This function can only write at most JUNKBUFSIZE to the string per call.

This function is not very fast. For loops with many iterations you might consider replacing it by other calls. Example:

SWBuf buf.appendFormatted("<%s>", stringVal); 

should be replaced by:

buf.append("<"); buf.append(stringVal); buf.append(">"); 

This will produce much faster results.

Parameters

format	The format string. Same syntax as printf, for example.
...	Add all arguments here.

Definition at line 81 of file swbuf.cpp.

                                                     {
    va_list argptr;

    va_start(argptr, format);
#ifdef NO_VSNPRINTF
    static char junkBuf[JUNKBUFSIZE];
    int len = vsprintf(junkBuf, format, argptr)+1;
#else
    int len = vsnprintf(0, 0, format, argptr)+1;
#endif
    va_end(argptr);
    assureMore(len);
    va_start(argptr, format);
    end += vsprintf(end, format, argptr);
    va_end(argptr);
    return *this;
}

void SWBuf::assureMore ( size_t  pastEnd )

inlineprivate

Definition at line 56 of file swbuf.h.

                                           {
        if (size_t(endAlloc-end) < pastEnd) {
            assureSize(allocSize + pastEnd);
        }
    }

void SWBuf::assureSize ( size_t  checkSize )

inlineprivate

Definition at line 62 of file swbuf.h.

                                             {
        if (checkSize > allocSize) {
            long size = (end - buf);
            checkSize += 128;
            buf = (char *)((allocSize) ? realloc(buf, checkSize) : malloc(checkSize));
            allocSize = checkSize;
            end = (buf + size);
            *end = 0;
            endAlloc = buf + allocSize - 1;
        }
    }

const char* SWBuf::c_str ( ) const

inline

Returns

a pointer to the buffer content (null-terminated string)

Definition at line 158 of file swbuf.h.

{ return buf; }

char& SWBuf::charAt ( unsigned long  pos )

inline

Definition at line 168 of file swbuf.h.

{ return *(buf + pos); }

const char& SWBuf::charAt ( unsigned long  pos ) const

inline

Definition at line 169 of file swbuf.h.

{ return *(buf + pos); }

char& SWBuf::charAtGuarded ( unsigned long  pos )

inline

Parameters

pos	The position of the requested character.

Returns

The character at the specified position

Definition at line 165 of file swbuf.h.

{ return ((pos <= (unsigned long)(endAlloc - buf)) ? buf[pos] : (*endAlloc)); }

int SWBuf::compare ( const SWBuf &  other ) const

inline

Definition at line 508 of file swbuf.h.

{ return strcmp(c_str(), other.c_str()); }

int SWBuf::compare ( const char *  other ) const

inline

Definition at line 527 of file swbuf.h.

{ return (other?strcmp(c_str(), other):-1); }

bool SWBuf::endsWith ( const SWBuf &  postfix ) const

inline

Returns

returns true if this buffer ends with the specified postfix

Definition at line 501 of file swbuf.h.

{ return (size() >= postfix.size())?!strncmp(end-postfix.size(), postfix.c_str(), postfix.size()):false; }

bool SWBuf::endsWith ( const char *  postfix ) const

inline

Returns

returns true if this buffer ends with the specified postfix

Definition at line 524 of file swbuf.h.

{ unsigned int psize = (unsigned int)strlen(postfix); return (size() >= psize)?!strncmp(end-psize, postfix, psize):false; }

char SWBuf::getFillByte ( )

inline

SWBuf::getFillByte - Get the fillByte character

Returns

The character used for filling memory.

See Also

setFillByte.

Definition at line 153 of file swbuf.h.

{ return fillByte; }

char* SWBuf::getRawData ( )

inline

SWBuf::getRawData

Warning

be careful! Probably setSize needs to be called in conjunction before and maybe after

Returns

Pointer to the allocated memory of the SWBuf.

Definition at line 379 of file swbuf.h.

{ return buf; }

long SWBuf::indexOf ( const SWBuf &  needle ) const

inline

Returns

returns the index of a substring if it is found in this buffer; otherwise, returns < 0

Definition at line 506 of file swbuf.h.

{ const char *ch = strstr(buf, needle.c_str()); return (ch) ? ch - buf : -1; }

void SWBuf::init ( size_t  initSize )

inlineprivate

Definition at line 74 of file swbuf.h.

                                      {
        fillByte = ' ';
        allocSize = 0;
        buf = nullStr;
        end = buf;
        endAlloc = buf;
        if (initSize)
            assureSize(initSize);
    }

void SWBuf::insert	(	unsigned long	pos,
		const char *	str,
		unsigned long	start = 0,
		signed long	max = -1
	)

SWBuf::insert - inserts the given string at position into this string

Parameters

pos	The position where to insert. pos=0 inserts at the beginning, pos=1 after the first char, etc. Using pos=length() is the same as calling append(s)
str	string to be inserted
start	start from this position in the string to be inserted
max	Insert only max chars.

Definition at line 99 of file swbuf.cpp.

                                                                                           {
//  if (!str) //A null string was passed
//      return;

    str += start;
    int len = (int)((max > -1) ? max : strlen(str));

    if (!len || (pos > length())) //nothing to do, return
        return;
    
    // pos==length(), so we can call append in this case
    if (pos == length()) { //append is more efficient
        append(str, max);
        return;
    }
    
    assureMore( len );
    
    memmove(buf + pos + len, buf + pos, (end - buf) - pos); //make a gap of "len" bytes
    memcpy(buf+pos, str, len);
    
    end += len;
    *end = 0;
}

void SWBuf::insert ( unsigned long  pos, const SWBuf &  str, unsigned long  start = 0, signed long  max = -1  )

inline

SWBuf::insert - inserts the given string at position into this string

Parameters

pos	The position where to insert. pos=0 inserts at the beginning, pos=1 after the first char, etc. Using pos=length() is the same as calling append(s)
str	string to be inserted
start	start from this position in the string to be inserted
max	Insert only max chars.

Definition at line 360 of file swbuf.h.

                                                                                                           {
        insert(pos, str.c_str(), start, max);
    };

void SWBuf::insert ( unsigned long  pos, char  c  )

inline

SWBuf::insert - inserts the given character at position into this string

Parameters

pos	The position where to insert. pos=0 inserts at the beginning, pos=1 after the first char, etc. Using pos=length() is the same as calling append(s)
c	Insert this.

Definition at line 369 of file swbuf.h.

                                                  {
        insert(pos, SWBuf(c));
    }

unsigned long SWBuf::length ( ) const

inline

Returns

size() and length() return only the number of characters of the string.

Definition at line 197 of file swbuf.h.

{ return end - buf; }

SWBuf::operator const char * ( ) const

inline

Definition at line 381 of file swbuf.h.

{ return c_str(); }

bool SWBuf::operator!= ( const SWBuf &  other ) const

inline

Definition at line 510 of file swbuf.h.

{ return compare(other) != 0; }

bool SWBuf::operator!= ( const char *  other ) const

inline

Definition at line 529 of file swbuf.h.

{ return compare(other) != 0; }

SWBuf SWBuf::operator+ ( const SWBuf &  other ) const

inline

Concatenate another buffer to the end of this buffer

Definition at line 419 of file swbuf.h.

                                                      {
        SWBuf retVal = buf;
        retVal += other;
        return retVal;
    }

SWBuf SWBuf::operator+ ( char  ch ) const

inline

Concatenate a byte to the end of this buffer

Definition at line 428 of file swbuf.h.

{ return (*this) + SWBuf(ch); }

SWBuf& SWBuf::operator+= ( const char *  str )

inline

Definition at line 392 of file swbuf.h.

{ return append(str); }

SWBuf& SWBuf::operator+= ( char  ch )

inline

Definition at line 393 of file swbuf.h.

{ return append(ch); }

SWBuf& SWBuf::operator-- ( int  )

inline

Decrease the buffer size, discarding the last character

Definition at line 404 of file swbuf.h.

{ operator -=(1); return *this; }

SWBuf& SWBuf::operator-= ( unsigned long  len )

inline

Decrease the buffer size, discarding the last characters

Parameters

len	how many bytes to decrease the buffer size

Definition at line 399 of file swbuf.h.

{ setSize(length()-len); return *this; }

bool SWBuf::operator< ( const SWBuf &  other ) const

inline

Definition at line 512 of file swbuf.h.

{ return compare(other) < 0; }

bool SWBuf::operator< ( const char *  other ) const

inline

Definition at line 531 of file swbuf.h.

{ return other && compare(other) < 0; }

SWBuf& SWBuf::operator<< ( unsigned long  n )

inline

Shift the buffer to the left, discarding the first bytes, decreasing the buffer size

Definition at line 409 of file swbuf.h.

{ if (n && length()) { n = (n<=length())?n:(length()-1); memmove(buf, buf+n, length()-n); (*this)-=n; } return *this; }

bool SWBuf::operator<= ( const SWBuf &  other ) const

inline

Definition at line 513 of file swbuf.h.

{ return compare(other) <= 0; }

bool SWBuf::operator<= ( const char *  other ) const

inline

Definition at line 532 of file swbuf.h.

{ return other && compare(other) <= 0; }

SWBuf& SWBuf::operator= ( const char *  newVal )

inline

Definition at line 390 of file swbuf.h.

{ set(newVal); return *this; }

SWBuf& SWBuf::operator= ( const SWBuf &  other )

inline

Definition at line 391 of file swbuf.h.

{ set(other); return *this; }

bool SWBuf::operator== ( const SWBuf &  other ) const

inline

Definition at line 509 of file swbuf.h.

{ return compare(other) == 0; }

bool SWBuf::operator== ( const char *  other ) const

inline

Definition at line 528 of file swbuf.h.

{ return compare(other) == 0; }

bool SWBuf::operator> ( const SWBuf &  other ) const

inline

Definition at line 511 of file swbuf.h.

{ return compare(other) > 0; }

bool SWBuf::operator> ( const char *  other ) const

inline

Definition at line 530 of file swbuf.h.

{ return other && compare(other) > 0; }

bool SWBuf::operator>= ( const SWBuf &  other ) const

inline

Definition at line 514 of file swbuf.h.

{ return compare(other) >= 0; }

bool SWBuf::operator>= ( const char *  other ) const

inline

Definition at line 533 of file swbuf.h.

{ return other && compare(other) >= 0; }

SWBuf& SWBuf::operator>> ( unsigned long  n )

inline

Shift the buffer to the right, increasing the buffer size

Definition at line 414 of file swbuf.h.

{ setSize(length()+n); memmove(buf+n, buf, length()-n); return *this; }

char& SWBuf::operator[] ( unsigned long  pos )

inline

Definition at line 382 of file swbuf.h.

{ return charAt(pos); }

char& SWBuf::operator[] ( long  pos )

inline

Definition at line 383 of file swbuf.h.

{ return charAt((unsigned long)pos); }

char& SWBuf::operator[] ( unsigned int  pos )

inline

Definition at line 384 of file swbuf.h.

{ return charAt((unsigned long)pos); }

char& SWBuf::operator[] ( int  pos )

inline

Definition at line 385 of file swbuf.h.

{ return charAt((unsigned long)pos); }

const char& SWBuf::operator[] ( unsigned long  pos ) const

inline

Definition at line 386 of file swbuf.h.

{ return charAt(pos); }

const char& SWBuf::operator[] ( long  pos ) const

inline

Definition at line 387 of file swbuf.h.

{ return charAt((unsigned long)pos); }

const char& SWBuf::operator[] ( unsigned int  pos ) const

inline

Definition at line 388 of file swbuf.h.

{ return charAt((unsigned long)pos); }

const char& SWBuf::operator[] ( int  pos ) const

inline

Definition at line 389 of file swbuf.h.

{ return charAt((unsigned long)pos); }

SWBuf& SWBuf::replaceBytes ( const char *  targets, char  newByte  )

inline

Replace with a new byte value all occurances in this buffer of any byte value specified in a set

Parameters

targets	a set of bytes, any of which will be replaced
newByte	value to use as replacement or 0 to remove matching byte.

Example: replaceBytes("abc", 'z'); // replaces all occurances of 'a', 'b', and 'c' with 'z'

Definition at line 467 of file swbuf.h.

                                                                  {
        for (unsigned int i = 0; (i < size()); i++) {
            if (strchr(targets, buf[i])) {
                if (newByte) buf[i] = newByte;
                // delete byte
                else {
                    if (i < (size()-1)) {
                        memmove(buf+i, buf+i+1, length()-i-1);
                    }
                    (*this)-=1;
                }
            }
        }
        return *this;
    }

void SWBuf::resize ( unsigned long  len )

inline

SWBuf::resize - Resize this buffer to a specific length.

Parameters

len	The new size of the buffer. One byte for the null will be added.

Definition at line 266 of file swbuf.h.

{ setSize(len); }

void SWBuf::set ( const SWBuf &  newVal )

inline

SWBuf::set - sets this buf to a new value If the allocated memory is bigger than the new string, it will NOT be resized.

Parameters

newVal

the value to set this buffer to.

Definition at line 204 of file swbuf.h.

                                         {
        unsigned long len = newVal.allocSize;
        assureSize(len);
        memcpy(buf, newVal.c_str(), len);
        end = buf + (newVal.length());
    }

void SWBuf::set ( const char *  newVal, unsigned long  maxSize = 0  )

inline

SWBuf::set - sets this buf to a new value. If the allocated memory is bigger than the new string, it will NOT be resized.

Parameters

newVal

the value to set this buffer to.

Definition at line 216 of file swbuf.h.

                                                                   {
        if (newVal) {
            unsigned long len = strlen(newVal) + 1;
            if (maxSize && maxSize < (len-1)) len = maxSize + 1;
            assureSize(len);
            memcpy(buf, newVal, len);
            end = buf + (len - 1);
        }
        else {
            assureSize(1);
            end = buf;
        }
        *end = 0;
    }

void SWBuf::setFillByte ( char  ch )

inline

SWBuf::setFillByte - Set the fillByte character

Parameters

ch	This character is used when the SWBuf is (re)sized. The memory will be filled with this character.

See Also

setSize()

resize()

Definition at line 146 of file swbuf.h.

{ fillByte = ch; }

SWBuf & SWBuf::setFormatted	(	const char *	format,
			...
	)

SWBuf::setFormatted - sets this buf to a formatted string. If the allocated memory is bigger than the new string, it will NOT be resized.

Warning

This function can only write at most JUNKBUFSIZE to the string per call.

This function is not very fast. For loops with many iterations you might consider replacing it by other calls. Example:

SWBuf buf.setFormatted("<%s>", stringVal); 

should be replaced by:

buf.set("<"); buf.append(stringVal); buf.append(">"); 

This will produce much faster results.

Parameters

format	The format string. Same syntax as printf, for example.
...	Add all arguments here.

Definition at line 50 of file swbuf.cpp.

                                                  {
    va_list argptr;

    va_start(argptr, format);

    setFormattedVA(format, argptr);

    va_end(argptr);
    return *this;
}

SWBuf & SWBuf::setFormattedVA	(	const char *	format,
		va_list	argptr
	)

Definition at line 61 of file swbuf.cpp.

                                                               {
    va_list argptr2;
    va_copy(argptr2, argptr);
#ifdef NO_VSNPRINTF
    static char junkBuf[JUNKBUFSIZE];
    int len = vsprintf(junkBuf, format, argptr)+1;
#else
    int len = vsnprintf(0, 0, format, argptr)+1;
#endif
    assureSize(len);
    end = vsprintf(buf, format, argptr2) + buf;
    va_end(argptr2);
    return *this;
}

void SWBuf::setSize ( unsigned long  len )

inline

SWBuf::setSize - Size this buffer to a specific length.

Parameters

len	The new size of the buffer. One byte for the null will be added.

Definition at line 255 of file swbuf.h.

                                           {
        assureSize(len+1);
        if ((unsigned)(end - buf) < len)
            memset(end, fillByte, (size_t)len - (end-buf));
        end = buf + len;
        *end = 0;
    }

unsigned long SWBuf::size ( ) const

inline

Returns

size() and length() return only the number of characters of the string. Add one for the following null and one for each char to be appended!

Definition at line 185 of file swbuf.h.

{ return length(); }

void SWBuf::size ( unsigned long  newSize )

inline

set's the size of the buffer. This is a quick inline method which checks for changes before actually calling setSize().

Parameters

newSize

new size of the buffer

Definition at line 192 of file swbuf.h.

{ if (end - buf - newSize) setSize(newSize); }

bool SWBuf::startsWith ( const SWBuf &  prefix ) const

inline

Returns

returns true if this buffer starts with the specified prefix

Definition at line 486 of file swbuf.h.

{ return !strncmp(c_str(), prefix.c_str(), prefix.size()); }

bool SWBuf::startsWith ( const char *  prefix ) const

inline

Returns

returns true if this buffer starts with the specified prefix

Definition at line 519 of file swbuf.h.

{ return !strncmp(c_str(), prefix, strlen(prefix)); }

const char* SWBuf::stripPrefix ( char  separator, bool  endOfStringAsSeparator = false  )

inline

Strip a prefix from this buffer up to a separator byte. Returns the prefix and modifies this buffer, shifting left to remove prefix

Parameters

separator	to use (e.g. ':')
endOfStringAsSeparator	- also count end of string as separator. this is useful for tokenizing entire string like: x|y|z if true it will also include 'z'.

Returns

prefix if separator character found; otherwise, null and leaves buffer unmodified

Definition at line 457 of file swbuf.h.

{ const char *m = strchr(buf, separator); if (!m && endOfStringAsSeparator) { if (*buf) { operator >>(1); *buf=0; end = buf; return buf + 1;} else return buf; } if (m) { int len = (int)(m-buf); char *hold = new char[len]; memcpy(hold, buf, len); *this << (len+1); memcpy(end+1, hold, len); delete [] hold; end[len+1] = 0; } return (m) ? end+1 : 0; }   // safe.  we know we don't actually realloc and shrink buffer when shifting, so we can place our return val at end.

SWBuf & SWBuf::toLower

(

)

Converts this SWBuf to lowercase &return this

Definition at line 141 of file swbuf.cpp.

                      {
    char *utf8 = 0;
    stdstr(&utf8, c_str(), 3);
    sword::tolowerstr(utf8, (unsigned int)size()*3-1);
    *this = utf8;
    delete [] utf8;

    return *this;
}

SWBuf & SWBuf::toUpper

(

)

Converts this SWBuf to uppercase &return this

Converts an SWBuf filled with UTF-8 to upper case

Parameters

b	SWBuf to change to upper case

Returns

b for convenience

Definition at line 132 of file swbuf.cpp.

                      { 
    char *utf8 = 0;
    stdstr(&utf8, c_str(), 3);
    sword::toupperstr(utf8, (unsigned int)size()*3-1);
    *this = utf8;
    delete [] utf8;

    return *this;
}

SWBuf& SWBuf::trim ( )

inline

Trim whitespace from the start and end of this buffer, shifting left and decreasing size as necessary

Definition at line 443 of file swbuf.h.

{ trimStart(); return trimEnd(); }

SWBuf& SWBuf::trimEnd ( )

inline

Trim whitespace from the end of this buffer, decreasing the size as necessary

Definition at line 438 of file swbuf.h.

{ while (size() && (strchr("\t\r\n ", *(end-1)))) setSize(size()-1); return *this; }

SWBuf& SWBuf::trimStart ( )

inline

Trim whitespace from the start of this buffer, shifting the buffer left as necessary

Definition at line 433 of file swbuf.h.

{ while (size() && (strchr("\t\r\n ", *(buf)))) *this << 1; return *this; }

Member Data Documentation

unsigned long SWBuf::allocSize

private

Definition at line 54 of file swbuf.h.

char* SWBuf::buf

private

Definition at line 50 of file swbuf.h.

char* SWBuf::end

private

Definition at line 51 of file swbuf.h.

char* SWBuf::endAlloc

private

Definition at line 52 of file swbuf.h.

char SWBuf::fillByte

private

Definition at line 53 of file swbuf.h.

SWORD_NAMESPACE_START char * SWBuf::nullStr = (char *)""

static

Definition at line 87 of file swbuf.h.

---

The documentation for this class was generated from the following files:

• include/swbuf.h
• src/utilfuns/swbuf.cpp