wstringbuffer Class Reference

Inherits bytebuffer.

Public Member Functions
	wstringbuffer ()
	wstringbuffer (size_t initialsize)
	wstringbuffer (wchar_t *initialcontents, size_t initialsize)
	wstringbuffer (wstringbuffer &s)
wstringbuffer &	operator= (wstringbuffer &s)
	~wstringbuffer ()
off64_t	setPositionRelativeToBeginning (off64_t pos)
off64_t	setPositionRelativeToCurrent (off64_t pos)
off64_t	setPositionRelativeToEnd (off64_t pos)
off64_t	getPosition ()
ssize_t	write (const wchar_t *string)
ssize_t	write (const wchar_t *string, size_t length)
ssize_t	write (wchar_t character)
ssize_t	write (int16_t number)
ssize_t	write (int32_t number)
ssize_t	write (int64_t number)
ssize_t	write (uint16_t number)
ssize_t	write (uint32_t number)
ssize_t	write (uint64_t number)
ssize_t	write (float number)
ssize_t	write (float number, uint16_t scale)
ssize_t	write (float number, uint16_t precision, uint16_t scale)
ssize_t	write (double number)
ssize_t	write (double number, uint16_t scale)
ssize_t	write (double number, uint16_t precision, uint16_t scale)
wstringbuffer *	append (const wchar_t *string)
wstringbuffer *	append (const wchar_t *string, size_t length)
wstringbuffer *	append (wchar_t character)
wstringbuffer *	append (int16_t number)
wstringbuffer *	append (int32_t number)
wstringbuffer *	append (int64_t number)
wstringbuffer *	append (uint16_t number)
wstringbuffer *	append (uint32_t number)
wstringbuffer *	append (uint64_t number)
wstringbuffer *	append (int16_t number, uint16_t zeropadding)
wstringbuffer *	append (int32_t number, uint16_t zeropadding)
wstringbuffer *	append (int64_t number, uint16_t zeropadding)
wstringbuffer *	append (uint16_t number, uint16_t zeropadding)
wstringbuffer *	append (uint32_t number, uint16_t zeropadding)
wstringbuffer *	append (uint64_t number, uint16_t zeropadding)
wstringbuffer *	append (float number)
wstringbuffer *	append (float number, uint16_t scale)
wstringbuffer *	append (float number, uint16_t precision, uint16_t scale)
wstringbuffer *	append (double number)
wstringbuffer *	append (double number, uint16_t scale)
wstringbuffer *	append (double number, uint16_t precision, uint16_t scale)
void	truncate (size_t pos)
void	truncate ()
bool	clear ()
bool	clear (size_t initialsize)
bool	clear (wchar_t *initialcontents, size_t initialsize)
const wchar_t *	getString ()
wchar_t *	detachString ()
size_t	getStringLength ()
Public Member Functions inherited from bytebuffer
	bytebuffer ()
	bytebuffer (size_t initialsize)
	bytebuffer (byte_t *initialcontents, size_t initialsize)
	bytebuffer (bytebuffer &v)
bytebuffer &	operator= (bytebuffer &v)
virtual	~bytebuffer ()
ssize_t	write (const byte_t *data, size_t size)
ssize_t	write (const char *string, size_t length)
ssize_t	write (const char *string)
ssize_t	writeUcs2 (const ucs2_t *string, size_t length)
ssize_t	writeUcs2 (const ucs2_t *string)
ssize_t	write (char character)
ssize_t	writeUcs2 (ucs2_t character)
ssize_t	write (byte_t character)
bytebuffer *	append (const byte_t *data, size_t size)
bytebuffer *	append (const char *string, size_t length)
bytebuffer *	append (const char *string)
bytebuffer *	append (const wchar_t *string, size_t length)
bytebuffer *	append (const wchar_t *string)
bytebuffer *	appendUcs2 (const ucs2_t *string, size_t length)
bytebuffer *	appendUcs2 (const ucs2_t *string)
bytebuffer *	append (char character)
bytebuffer *	append (wchar_t character)
bytebuffer *	appendUcs2 (ucs2_t character)
bytebuffer *	append (int16_t number)
bytebuffer *	append (int32_t number)
bytebuffer *	append (int64_t number)
bytebuffer *	append (byte_t character)
bytebuffer *	append (uint16_t number)
bytebuffer *	append (uint32_t number)
bytebuffer *	append (uint64_t number)
bytebuffer *	append (float number)
bytebuffer *	append (double number)
ssize_t	read (byte_t *data, size_t size)
bool	clear ()
bool	clear (size_t initialsize)
bool	clear (byte_t *initialcontents, size_t initialsize)
const byte_t *	getBuffer ()
size_t	getSize ()
size_t	getActualSize ()
size_t	getInitialSize ()
byte_t *	detachBuffer ()
Public Member Functions inherited from output
	output ()
virtual	~output ()
virtual ssize_t	write (const byte_t *string, size_t size, int32_t sec, int32_t usec)
virtual ssize_t	write (const char *string, int32_t sec, int32_t usec)
virtual ssize_t	write (const char *string, size_t length, int32_t sec, int32_t usec)
virtual ssize_t	write (char character, int32_t sec, int32_t usec)
virtual ssize_t	write (const wchar_t *string, int32_t sec, int32_t usec)
virtual ssize_t	write (const wchar_t *string, size_t length, int32_t sec, int32_t usec)
virtual ssize_t	write (wchar_t character, int32_t sec, int32_t usec)
virtual ssize_t	writeUcs2 (const ucs2_t *string, int32_t sec, int32_t usec)
virtual ssize_t	writeUcs2 (const ucs2_t *string, size_t length, int32_t sec, int32_t usec)
virtual ssize_t	writeUcs2 (ucs2_t character, int32_t sec, int32_t usec)
virtual ssize_t	write (int16_t number, int32_t sec, int32_t usec)
virtual ssize_t	write (int32_t number, int32_t sec, int32_t usec)
virtual ssize_t	write (int64_t number, int32_t sec, int32_t usec)
virtual ssize_t	write (byte_t character, int32_t sec, int32_t usec)
virtual ssize_t	write (uint16_t number, int32_t sec, int32_t usec)
virtual ssize_t	write (uint32_t number, int32_t sec, int32_t usec)
virtual ssize_t	write (uint64_t number, int32_t sec, int32_t usec)
virtual ssize_t	write (float number, int32_t sec, int32_t usec)
virtual ssize_t	write (double number, int32_t sec, int32_t usec)
virtual ssize_t	printf (const char *format,...)
virtual ssize_t	printf (const char *format, va_list *argp)
virtual ssize_t	printf (const wchar_t *format,...)
virtual ssize_t	printf (const wchar_t *format, va_list *argp)
virtual ssize_t	printfUcs2 (const ucs2_t *format,...)
virtual ssize_t	printfUcs2 (const ucs2_t *format, va_list *argp)
void	safePrint (byte_t c)
void	safePrint (const byte_t *str)
void	safePrint (const byte_t *str, int32_t length)
void	safePrint (char c)
void	safePrint (const char *str)
void	safePrint (const char *str, int32_t length)
void	printBits (byte_t value)
void	printBits (uint16_t value)
void	printBits (uint32_t value)
void	printBits (uint64_t value)
void	printBits (char value)
void	printBits (int16_t value)
void	printBits (int32_t value)
void	printBits (int64_t value)
void	printBits (const byte_t *bits, uint64_t size)
void	printHex (const byte_t *data, uint64_t size)
void	printHex (const byte_t *data, uint64_t size, uint16_t indent)
Public Member Functions inherited from object
virtual	~object ()

Detailed Description

The wstringbuffer class can be used to store wide strings of arbitrary length.

It is generally more efficient to reuse the same wstringbuffer over and over than to allocate a new one for each operation.

Constructor & Destructor Documentation

wstringbuffer() [1/4]

wstringbuffer::wstringbuffer ( )

inline

Creates an instance of the wstringbuffer class with default initial size.

wstringbuffer() [2/4]

wstringbuffer::wstringbuffer ( size_t  initialsize )

inline

Creates an instance of the wstringbuffer class with the specified "initialsize".

wstringbuffer() [3/4]

wstringbuffer::wstringbuffer ( wchar_t *  initialcontents, size_t  initialsize  )

inline

Creates an instance of the wstringbuffer class. The buffer "initialcontents" will be attached to the instance and used as the initial contents. This buffer should not be freed by the calling program. The initial size may be specified by the "initialsize" parameter.

wstringbuffer() [4/4]

wstringbuffer::wstringbuffer ( wstringbuffer &  s )

inline

Creates an instance of the wstringbuffer class that is a copy of "s".

~wstringbuffer()

wstringbuffer::~wstringbuffer ( )

inline

Deletes this instance of the wstringbuffer class.

Member Function Documentation

append() [1/21]

wstringbuffer * wstringbuffer::append ( const wchar_t *  string )

inline

Appends "string" to the wstringbuffer, growing the internal buffer as necessary to accommodate the new data.

Returns a pointer to "this" to enable chaining such as: sb->append("numbers: ")->append(5)->append(5.5);

append() [2/21]

wstringbuffer * wstringbuffer::append ( const wchar_t *  string, size_t  length  )

inline

Appends the first "length" characters of "string" to the wstringbuffer, growing the internal buffer as necessary to accommodate the new data.

Returns a pointer to "this" to enable chaining such as: sb->append("numbers: ")->append(5)->append(5.5);

append() [3/21]

wstringbuffer * wstringbuffer::append ( double  number )

inline

Converts "number" to a string (using a default scale of 4) and appends it to the wstringbuffer, growing the internal buffer as necessary to accommodate the new data.

Returns a pointer to "this" to enable chaining such as: sb->append("numbers: ")->append(5)->append(5.5);

append() [4/21]

wstringbuffer * wstringbuffer::append ( double  number, uint16_t  precision, uint16_t  scale  )

inline

Converts "number" to a string using the specified "precision" and "scale" and appends it to the wstringbuffer, growing the internal buffer as necessary to accommodate the new data.

Returns a pointer to "this" to enable chaining such as: sb->append("numbers: ")->append(5)->append(5.5);

append() [5/21]

wstringbuffer * wstringbuffer::append ( double  number, uint16_t  scale  )

inline

Converts "number" to a string using the specified "scale" and appends it to the wstringbuffer, growing the internal buffer as necessary to accommodate the new data.

Returns a pointer to "this" to enable chaining such as: sb->append("numbers: ")->append(5)->append(5.5);

append() [6/21]

wstringbuffer * wstringbuffer::append ( float  number )

inline

Converts "number" to a string (using a default scale of 4) and appends it to the wstringbuffer, growing the internal buffer as necessary to accommodate the new data.

Returns a pointer to "this" to enable chaining such as: sb->append("numbers: ")->append(5)->append(5.5);

append() [7/21]

wstringbuffer * wstringbuffer::append ( float  number, uint16_t  precision, uint16_t  scale  )

inline

Converts "number" to a string using the specified "precision" and "scale" and appends it to the wstringbuffer, growing the internal buffer as necessary to accommodate the new data.

Returns a pointer to "this" to enable chaining such as: sb->append("numbers: ")->append(5)->append(5.5);

append() [8/21]

wstringbuffer * wstringbuffer::append ( float  number, uint16_t  scale  )

inline

Converts "number" to a string using the specified "scale" and appends it to the wstringbuffer, growing the internal buffer as necessary to accommodate the new data.

Returns a pointer to "this" to enable chaining such as: sb->append("numbers: ")->append(5)->append(5.5);

append() [9/21]

wstringbuffer * wstringbuffer::append ( int16_t  number )

inline

Converts "number" to a string and appends it to the wstringbuffer, growing the internal buffer as necessary to accommodate the new data.

Returns a pointer to "this" to enable chaining such as: sb->append("numbers: ")->append(5)->append(5.5);

append() [10/21]

wstringbuffer * wstringbuffer::append ( int16_t  number, uint16_t  zeropadding  )

inline

Converts "number" to a string with the specified amount of zeropadding and appends it to the wstringbuffer, growing the internal buffer as necessary to accommodate the new data.

Returns a pointer to "this" to enable chaining such as: sb->append("numbers: ")->append(5)->append(5.5);

append() [11/21]

wstringbuffer * wstringbuffer::append ( int32_t  number )

inline

Converts "number" to a string and appends it to the wstringbuffer, growing the internal buffer as necessary to accommodate the new data.

Returns a pointer to "this" to enable chaining such as: sb->append("numbers: ")->append(5)->append(5.5);

append() [12/21]

wstringbuffer * wstringbuffer::append ( int32_t  number, uint16_t  zeropadding  )

inline

Converts "number" to a string with the specified amount of zeropadding and appends it to the wstringbuffer, growing the internal buffer as necessary to accommodate the new data.

Returns a pointer to "this" to enable chaining such as: sb->append("numbers: ")->append(5)->append(5.5);

append() [13/21]

wstringbuffer * wstringbuffer::append ( int64_t  number )

inline

Converts "number" to a string and appends it to the wstringbuffer, growing the internal buffer as necessary to accommodate the new data.

Returns a pointer to "this" to enable chaining such as: sb->append("numbers: ")->append(5)->append(5.5);

append() [14/21]

wstringbuffer * wstringbuffer::append ( int64_t  number, uint16_t  zeropadding  )

inline

Converts "number" to a string with the specified amount of zeropadding and appends it to the wstringbuffer, growing the internal buffer as necessary to accommodate the new data.

Returns a pointer to "this" to enable chaining such as: sb->append("numbers: ")->append(5)->append(5.5);

append() [15/21]

wstringbuffer * wstringbuffer::append ( uint16_t  number )

inline

Converts "number" to a string and appends it to the wstringbuffer, growing the internal buffer as necessary to accommodate the new data.

Returns a pointer to "this" to enable chaining such as: sb->append("numbers: ")->append(5)->append(5.5);

append() [16/21]

wstringbuffer * wstringbuffer::append ( uint16_t  number, uint16_t  zeropadding  )

inline

Converts "number" to a string with the specified amount of zeropadding and appends it to the wstringbuffer, growing the internal buffer as necessary to accommodate the new data.

Returns a pointer to "this" to enable chaining such as: sb->append("numbers: ")->append(5)->append(5.5);

append() [17/21]

wstringbuffer * wstringbuffer::append ( uint32_t  number )

inline

Converts "number" to a string and appends it to the wstringbuffer, growing the internal buffer as necessary to accommodate the new data.

Returns a pointer to "this" to enable chaining such as: sb->append("numbers: ")->append(5)->append(5.5);

append() [18/21]

wstringbuffer * wstringbuffer::append ( uint32_t  number, uint16_t  zeropadding  )

inline

Converts "number" to a string with the specified amount of zeropadding and appends it to the wstringbuffer, growing the internal buffer as necessary to accommodate the new data.

Returns a pointer to "this" to enable chaining such as: sb->append("numbers: ")->append(5)->append(5.5);

append() [19/21]

wstringbuffer * wstringbuffer::append ( uint64_t  number )

inline

Converts "number" to a string and appends it to the wstringbuffer, growing the internal buffer as necessary to accommodate the new data.

Returns a pointer to "this" to enable chaining such as: sb->append("numbers: ")->append(5)->append(5.5);

append() [20/21]

wstringbuffer * wstringbuffer::append ( uint64_t  number, uint16_t  zeropadding  )

inline

Converts "number" to a string with the specified amount of zeropadding and appends it to the wstringbuffer, growing the internal buffer as necessary to accommodate the new data.

Returns a pointer to "this" to enable chaining such as: sb->append("numbers: ")->append(5)->append(5.5);

append() [21/21]

wstringbuffer * wstringbuffer::append ( wchar_t  character )

inline

Appends "character" to the wstringbuffer, growing the internal buffer as necessary to accommodate the new data.

Returns a pointer to "this" to enable chaining such as: sb->append("numbers: ")->append(5)->append(5.5);

clear() [1/3]

bool wstringbuffer::clear ( )

inline

Empties the wstringbuffer.

Always returns true.

clear() [2/3]

bool wstringbuffer::clear ( size_t  initialsize )

inline

Empties the bytebuffer and resets the specified "initialsize" parameter.

Always returns true.

clear() [3/3]

bool wstringbuffer::clear ( wchar_t *  initialcontents, size_t  initialsize  )

inline

Empties the bytebuffer and attaches the buffer "initialcontents" to the instance as the initial contents. This buffer should not be freed by the calling program. Also resets the specified "initialsize" parameter.

Always returns true.

detachString()

wchar_t * wstringbuffer::detachString ( )

inline

Returns a pointer to the string currently stored in the wstringbuffer, then resets the wstringbuffer such that it will no longer use that string.

The calling program must deallocate the string returned from this method.

getPosition()

off64_t wstringbuffer::getPosition ( )

inlinevirtual

Returns the position in the internal buffer at which the next write will occur.

Reimplemented from bytebuffer.

getString()

const wchar_t * wstringbuffer::getString ( )

inline

Returns the string currently stored in the wstringbuffer.

getStringLength()

size_t wstringbuffer::getStringLength ( )

inline

Returns the length of the string currently stored in the wstringbuffer.

operator=()

wstringbuffer & wstringbuffer::operator= ( wstringbuffer &  s )

inline

Makes this instance of the wstringbuffer class identical to "s".

setPositionRelativeToBeginning()

off64_t wstringbuffer::setPositionRelativeToBeginning ( off64_t  pos )

inlinevirtual

Sets the position (relative to the beginning of the buffer) at which the next read or write will occur to "offset". If the position is set beyond the end of the buffer, the buffer will grow but the data between the current end of the buffer and the new position will be undefined.

Reimplemented from bytebuffer.

setPositionRelativeToCurrent()

off64_t wstringbuffer::setPositionRelativeToCurrent ( off64_t  pos )

inlinevirtual

Advances the position at which the next read or write will occur by "offset" bytes. If the position is set beyond the end of the buffer, the buffer will grow but the data between the current end of the buffer and the new position will be undefined.

Reimplemented from bytebuffer.

setPositionRelativeToEnd()

off64_t wstringbuffer::setPositionRelativeToEnd ( off64_t  pos )

inlinevirtual

Sets the position at which the next read or write will occur to the end of the buffer plus "offset" bytes. Generally, offset will be negative. If it is positive then the buffer will grow, but the data between the current buffer will grow but the data between the current end of the buffer and the new position will be undefined.

Reimplemented from bytebuffer.

truncate() [1/2]

void wstringbuffer::truncate ( )

inlinevirtual

Trucnates the wstringbuffer at the current position.

Reimplemented from bytebuffer.

truncate() [2/2]

void wstringbuffer::truncate ( size_t  pos )

inlinevirtual

Trucnates the wstringbuffer at position "pos".

Reimplemented from bytebuffer.

write() [1/15]

ssize_t wstringbuffer::write ( const wchar_t *  string )

inlinevirtual

Writes "string" to the wstringbuffer at the current position and increments the current position to the next byte after the data that was written. If necessary, the internal buffer will grow to accommodate the new data.

Returns a pointer to "this" to enable chaining such as: sb->write("numbers: ")->write(5)->write(5.5);

Reimplemented from bytebuffer.

write() [2/15]

ssize_t wstringbuffer::write ( const wchar_t *  string, size_t  length  )

inlinevirtual

Writes the first "length" characters of "string" to the wstringbuffer at the current position and increments the current position to the next byte after the data that was written. If necessary, the internal buffer will grow to accommodate the new data.

Returns a pointer to "this" to enable chaining such as: sb->write("numbers: ")->write(5)->write(5.5);

Reimplemented from bytebuffer.

write() [3/15]

ssize_t wstringbuffer::write ( double  number )

inlinevirtual

Converts "number" to a string (using a default scale of 4) and writes it to the wstringbuffer at the current position and increments the current position to the next byte after the data that was written. If necessary, the internal buffer will grow to accommodate the new data.

Returns a pointer to "this" to enable chaining such as: sb->write("numbers: ")->write(5)->write(5.5);

Reimplemented from bytebuffer.

write() [4/15]

ssize_t wstringbuffer::write ( double  number, uint16_t  precision, uint16_t  scale  )

inline

Converts "number" to a string using the specified "precision" and "scale" and writes it to the wstringbuffer at the current position and increments the current position to the next byte after the data that was written. If necessary, the internal buffer will grow to accommodate the new data.

Returns a pointer to "this" to enable chaining such as: sb->write("numbers: ")->write(5)->write(5.5);

write() [5/15]

ssize_t wstringbuffer::write ( double  number, uint16_t  scale  )

inline

Converts "number" to a string using the specified "scale" and writes it to the wstringbuffer at the current position and increments the current position to the next byte after the data that was written. If necessary, the internal buffer will grow to accommodate the new data.

Returns a pointer to "this" to enable chaining such as: sb->write("numbers: ")->write(5)->write(5.5);

write() [6/15]

ssize_t wstringbuffer::write ( float  number )

inlinevirtual

Converts "number" to a string (using a default scale of 4) and writes it to the wstringbuffer at the current position and increments the current position to the next byte after the data that was written. If necessary, the interna buffer will grow to accommodate the new data.

Returns a pointer to "this" to enable chaining such as: sb->write("numbers: ")->write(5)->write(5.5);

Reimplemented from bytebuffer.

write() [7/15]

ssize_t wstringbuffer::write ( float  number, uint16_t  precision, uint16_t  scale  )

inline

Converts "number" to a string using the specified "precision" and "scale" and writes it to the wstringbuffer at the current position and increments the current position to the next byte after the data that was written. If necessary, the internal buffer will grow to accommodate the new data.

Returns a pointer to "this" to enable chaining such as: sb->write("numbers: ")->write(5)->write(5.5);

write() [8/15]

ssize_t wstringbuffer::write ( float  number, uint16_t  scale  )

inline

Converts "number" to a string using the specified "scale" and writes it to the wstringbuffer at the current position and increments the current position to the next byte after the data that was written. If necessary, the internal buffer will grow to accommodate the new data.

Returns a pointer to "this" to enable chaining such as: sb->write("numbers: ")->write(5)->write(5.5);

write() [9/15]

ssize_t wstringbuffer::write ( int16_t  number )

inlinevirtual

Converts "number" to a string and writes it to the wstringbuffer at the current position and increments the current position to the next byte after the data that was written. If necessary, the internal buffer will grow to accommodate the new data.

Returns a pointer to "this" to enable chaining such as: sb->write("numbers: ")->write(5)->write(5.5);

Reimplemented from bytebuffer.

write() [10/15]

ssize_t wstringbuffer::write ( int32_t  number )

inlinevirtual

Converts "number" to a string and writes it to the wstringbuffer at the current position and increments the current position to the next byte after the data that was written. If necessary, the internal buffer will grow to accommodate the new data.

Returns a pointer to "this" to enable chaining such as: sb->write("numbers: ")->write(5)->write(5.5);

Reimplemented from bytebuffer.

write() [11/15]

ssize_t wstringbuffer::write ( int64_t  number )

inlinevirtual

Converts "number" to a string and writes it to the wstringbuffer at the current position and increments the current position to the next byte after the data that was written. If necessary, the inernal buffer will grow to accommodate the new data.

Returns a pointer to "this" to enable chaining such as: sb->write("numbers: ")->write(5)->write(5.5);

Reimplemented from bytebuffer.

write() [12/15]

ssize_t wstringbuffer::write ( uint16_t  number )

inlinevirtual

Converts "number" to a string and writes it to the wstringbuffer at the current position and increments the current position to the next byte after the data that was written. If necessary, the internal buffer will grow to accommodate the new data.

Returns a pointer to "this" to enable chaining such as: sb->write("numbers: ")->write(5)->write(5.5);

Reimplemented from bytebuffer.

write() [13/15]

ssize_t wstringbuffer::write ( uint32_t  number )

inlinevirtual

Converts "number" to a string and writes it to the wstringbuffer at the current position and increments the current position to the next byte after the data that was written. If necessary, the internal buffer will grow to accommodate the new data.

Returns a pointer to "this" to enable chaining such as: sb->write("numbers: ")->write(5)->write(5.5);

Reimplemented from bytebuffer.

write() [14/15]

ssize_t wstringbuffer::write ( uint64_t  number )

inlinevirtual

Converts "number" to a string and writes it to the wstringbuffer at the current position and increments the current position to the next byte after the data that was written. If necessary, the internal buffer will grow to accommodate the new data.

Returns a pointer to "this" to enable chaining such as: sb->write("numbers: ")->write(5)->write(5.5);

Reimplemented from bytebuffer.

write() [15/15]

ssize_t wstringbuffer::write ( wchar_t  character )

inlinevirtual

Writes "character" to the wstringbuffer at the current position and increments the current position to the next byte after the data that was written. If necessary, the internal buffer will grow to accommodate the new data.

Returns a pointer to "this" to enable chaining such as: sb->write("numbers: ")->write(5)->write(5.5);

Reimplemented from bytebuffer.