RWDBRow Class Reference
[Utilities and Diagnostics]

An ordered collection of RWDBValue instances. More...

#include <rw/db/row.h>

Inheritance diagram for RWDBRow:

List of all members.

Public Member Functions
virtual RWCollectable *	newSpecies () const
virtual RWClassID	isA () const
	RWDBRow ()
	RWDBRow (const RWDBRow &rvalue)
virtual	~RWDBRow ()
RWDBRow &	operator= (const RWDBRow &rvalue)
RWDBValue &	operator[] (size_t index) const
virtual void	append (const RWDBValue &value)
virtual size_t	entries () const
virtual void	clearAndDestroy ()
Static Public Member Functions
static RWClassID	classIsA ()

---

Detailed Description

RWDBRow is an ordered collection of RWDBValue objects. RWDBRow is a relatively low level construct used by the DB Interface Module to store a row of data on its way to or from the database. It is visible to applications for two reasons:

• An RWDBRow is a single row of an RWDBMemTable.

• Some applications may want to manage raw data without knowing anything about its structure. RWDBRow can be used as a container in these cases.

The only semantics that RWDBRow adds to RWCollectable are:

• The index operator operator[]() return RWDBValue&, rather than RWCollectable*&.

• The destructor deallocates the contents of the RWDBRow by calling clearAndDestroy().

RWDBRow is designed around the Interface/Implementation paradigm. An RWDBRow instance is an interface to a reference-counted implementation; copy constructors and assignment operators produce additional references to a shared implementation.

Synopsis

 #include <rw/db/row.h>

 RWDBRow& r = myMemTable[i];

---

Constructor & Destructor Documentation

RWDBRow::RWDBRow

(

)

The default constructor produces an empty RWDBRow.

RWDBRow::RWDBRow

(

const RWDBRow &

rvalue

)

Copy constructor. The created RWDBRow shares an implementation with rvalue.

virtual RWDBRow::~RWDBRow

(

)

[virtual]

The default destructor.

---

Member Function Documentation

virtual void RWDBRow::append

(

const RWDBValue &

value

)

[virtual]

Appends value to self.

static RWClassID RWDBRow::classIsA

(

)

[static]

Returns the RWClassID of this class.

Reimplemented from RWCollectable.

virtual void RWDBRow::clearAndDestroy

(

)

[virtual]

Removes all values from the collection and deletes them.

virtual size_t RWDBRow::entries

(

)

const [virtual]

Returns the total number of values in the collection.

virtual RWClassID RWDBRow::isA

(

)

const [virtual]

Returns __RWDBROW.

Reimplemented from RWCollectable.

virtual RWCollectable* RWDBRow::newSpecies

(

)

const [virtual]

Allocates a new object off the heap of the same type as self and returns a pointer to it. You are responsible for deleting the object when done with it.

Reimplemented from RWCollectable.

RWDBRow& RWDBRow::operator=

(

const RWDBRow &

rvalue

)

Assignment operator. Returns reference to self which shares an implementation with rvalue.

RWDBValue& RWDBRow::operator[]

(

size_t

index

)

const

Returns a reference to the RWDBValue at position index in the collection. Throws an exception of type RWBoundsErr if index is out of range.