lout::misc::StringBuffer Class Reference

A class for fast concatenation of a large number of strings. More...

#include <misc.hh>

Classes
struct	Node

Public Member Functions
	StringBuffer ()
	~StringBuffer ()
void	append (const char *str)
	Append a NUL-terminated string to the buffer, with copying.
void	appendInt (int n)
void	appendPointer (void *p)
void	appendBool (bool b)
void	appendNoCopy (char *str)
	Append a NUL-terminated string to the buffer, without copying.
const char *	getChars ()
	Return a NUL-terminated strings containing all appended strings.
void	clear ()
	Remove all strings appended to the string buffer.

Private Attributes
Node *	firstNode
Node *	lastNode
int	numChars
char *	str
bool	strValid

Detailed Description

A class for fast concatenation of a large number of strings.

Definition at line 566 of file misc.hh.

Constructor & Destructor Documentation

StringBuffer()

lout::misc::StringBuffer::StringBuffer

(

)

Definition at line 40 of file misc.cc.

References firstNode, lastNode, numChars, str, and strValid.

~StringBuffer()

lout::misc::StringBuffer::~StringBuffer

(

)

Definition at line 48 of file misc.cc.

References clear(), and str.

Member Function Documentation

append()

void lout::misc::StringBuffer::append ( const char *  str )

inline

Append a NUL-terminated string to the buffer, with copying.

A copy is kept in the buffer, so the caller does not have to care about memory management.

Definition at line 590 of file misc.hh.

References appendNoCopy(), dStrdup(), and str.

Referenced by appendBool(), appendInt(), appendPointer(), dw::core::SelectionState::copy(), dw::core::Content::intoStringBuffer(), dw::core::Iterator::intoStringBuffer(), dw::oof::OOFAwareWidget::OOFAwareWidgetIterator::intoStringBuffer(), dw::oof::OOFFloatsMgr::Float::intoStringBuffer(), dw::Textblock::BadnessAndPenalty::intoStringBuffer(), lout::container::untyped::Collection::intoStringBuffer(), lout::container::untyped::HashTable::intoStringBuffer(), lout::identity::IdentifiableObject::Class::intoStringBuffer(), lout::identity::IdentifiableObject::intoStringBuffer(), lout::misc::BitSet::intoStringBuffer(), lout::object::Object::intoStringBuffer(), lout::object::Pointer::intoStringBuffer(), lout::object::Integer::intoStringBuffer(), lout::object::Boolean::intoStringBuffer(), lout::object::ConstString::intoStringBuffer(), lout::object::PairBase::intoStringBuffer(), lout::signal::Emitter::intoStringBuffer(), lout::signal::Receiver::intoStringBuffer(), and dw::core::Content::maskIntoStringBuffer().

appendBool()

void lout::misc::StringBuffer::appendBool ( bool  b )

inline

Definition at line 595 of file misc.hh.

References append().

Referenced by dw::oof::OOFFloatsMgr::Float::intoStringBuffer().

appendInt()

void lout::misc::StringBuffer::appendInt ( int  n )

inline

Definition at line 591 of file misc.hh.

References append().

Referenced by dw::core::Content::intoStringBuffer(), dw::oof::OOFAwareWidget::OOFAwareWidgetIterator::intoStringBuffer(), dw::oof::OOFFloatsMgr::Float::intoStringBuffer(), dw::Textblock::BadnessAndPenalty::intoStringBuffer(), and lout::identity::IdentifiableObject::Class::intoStringBuffer().

appendNoCopy()

void lout::misc::StringBuffer::appendNoCopy

(

char *

str

)

Append a NUL-terminated string to the buffer, without copying.

No copy is made, so this method should only be used in cases, where the string would otherwise be freed again. (This method may then save some CPU cycles.)

Definition at line 62 of file misc.cc.

References lout::misc::StringBuffer::Node::data, firstNode, lastNode, lout::misc::StringBuffer::Node::next, numChars, str, and strValid.

Referenced by append(), and dw::core::SelectionState::copy().

appendPointer()

void lout::misc::StringBuffer::appendPointer ( void *  p )

inline

Definition at line 593 of file misc.hh.

References append().

Referenced by dw::core::Content::intoStringBuffer(), dw::core::Iterator::intoStringBuffer(), dw::oof::OOFFloatsMgr::Float::intoStringBuffer(), lout::identity::IdentifiableObject::intoStringBuffer(), and lout::object::Object::intoStringBuffer().

clear()

void lout::misc::StringBuffer::clear

(

)

Remove all strings appended to the string buffer.

Definition at line 110 of file misc.cc.

References lout::misc::StringBuffer::Node::data, firstNode, lastNode, lout::misc::StringBuffer::Node::next, numChars, and strValid.

Referenced by ~StringBuffer().

getChars()

const char * lout::misc::StringBuffer::getChars

(

)

Return a NUL-terminated strings containing all appended strings.

The caller does not have to free the string, this is done in misc::StringBuffer::~StringBuffer.

Definition at line 86 of file misc.cc.

References firstNode, lout::misc::StringBuffer::Node::next, numChars, str, and strValid.

Referenced by dw::Textblock::accumulateWordData(), dw::core::SelectionState::buttonPress(), dw::core::SelectionState::buttonRelease(), dw::core::SelectionState::copy(), dw::fltk::FltkImgbuf::copyRow(), dw::Textblock::TextblockIterator::highlight(), dw::fltk::FltkImgbuf::init(), dw::fltk::FltkImgbuf::newScan(), dw::oof::OOFAwareWidget::OOFAwareWidgetIterator::next(), dw::oof::OOFAwareWidget::OOFAwareWidgetIterator::prev(), dw::core::Content::print(), dw::core::Content::printMask(), dw::fltk::FltkImgbuf::scaleRowBeautiful(), dw::fltk::FltkImgbuf::scaleRowSimple(), dw::Textblock::searchBreakPos(), dw::Textblock::searchMinBap(), lout::object::Object::toString(), and dw::Textblock::TextblockIterator::unhighlight().

Member Data Documentation

firstNode

Node* lout::misc::StringBuffer::firstNode

private

Definition at line 575 of file misc.hh.

Referenced by appendNoCopy(), clear(), getChars(), and StringBuffer().

lastNode

Node * lout::misc::StringBuffer::lastNode

private

Definition at line 575 of file misc.hh.

Referenced by appendNoCopy(), clear(), and StringBuffer().

numChars

int lout::misc::StringBuffer::numChars

private

Definition at line 576 of file misc.hh.

Referenced by appendNoCopy(), clear(), getChars(), and StringBuffer().

str

char* lout::misc::StringBuffer::str

private

Definition at line 577 of file misc.hh.

Referenced by append(), appendNoCopy(), getChars(), StringBuffer(), and ~StringBuffer().

strValid

bool lout::misc::StringBuffer::strValid

private

Definition at line 578 of file misc.hh.

Referenced by appendNoCopy(), clear(), getChars(), and StringBuffer().

---

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

• lout/misc.hh
• lout/misc.cc