vtkRowQuery Class Reference

#include <vtkRowQuery.h>

Inheritance diagram for vtkRowQuery:

Inheritance graph
[legend]
Collaboration diagram for vtkRowQuery:

Collaboration graph
[legend]

List of all members.


Detailed Description

abstract interface for queries that return row-oriented results.

The abstract superclass of query classes that return row-oriented (table) results. A subclass will provide database-specific query parameters and implement the vtkRowQuery API to return query results:

Execute() - Execute the query. No results need to be retrieved at this point, unless you are performing caching.

GetNumberOfFields() - After Execute() is performed, returns the number of fields in the query results.

GetFieldName() - The name of the field at an index.

GetFieldType() - The data type of the field at an index.

NextRow() - Advances the query results by one row, and returns whether there are more rows left in the query.

DataValue() - Extract a single data value from the current row.

Thanks:
Thanks to Andrew Wilson from Sandia National Laboratories for his work on the database classes.
See also:
vtkRowQueryToTable

Definition at line 60 of file vtkRowQuery.h.


Public Types

typedef vtkObject Superclass

Public Member Functions

virtual const char * GetClassName ()
virtual int IsA (const char *type)
void PrintSelf (ostream &os, vtkIndent indent)
virtual bool Execute ()=0
virtual int GetNumberOfFields ()=0
virtual const char * GetFieldName (int i)=0
virtual int GetFieldType (int i)=0
int GetFieldIndex (char *name)
virtual bool NextRow ()=0
virtual bool IsActive ()=0
bool NextRow (vtkVariantArray *rowArray)
virtual vtkVariant DataValue (vtkIdType c)=0
virtual bool HasError ()=0
virtual const char * GetLastErrorText ()=0

Static Public Member Functions

static int IsTypeOf (const char *type)
static vtkRowQuerySafeDownCast (vtkObject *o)

Protected Member Functions

 vtkRowQuery ()
 ~vtkRowQuery ()

Member Typedef Documentation

Reimplemented from vtkObject.

Reimplemented in vtkMySQLQuery, vtkPostgreSQLQuery, vtkSQLiteQuery, and vtkSQLQuery.

Definition at line 63 of file vtkRowQuery.h.


Constructor & Destructor Documentation

vtkRowQuery::vtkRowQuery (  )  [protected]

vtkRowQuery::~vtkRowQuery (  )  [protected]


Member Function Documentation

virtual const char* vtkRowQuery::GetClassName (  )  [virtual]

Reimplemented from vtkObject.

Reimplemented in vtkMySQLQuery, vtkPostgreSQLQuery, vtkSQLiteQuery, and vtkSQLQuery.

static int vtkRowQuery::IsTypeOf ( const char *  name  )  [static]

Return 1 if this class type is the same type of (or a subclass of) the named class. Returns 0 otherwise. This method works in combination with vtkTypeRevisionMacro found in vtkSetGet.h.

Reimplemented from vtkObject.

Reimplemented in vtkMySQLQuery, vtkPostgreSQLQuery, vtkSQLiteQuery, and vtkSQLQuery.

virtual int vtkRowQuery::IsA ( const char *  name  )  [virtual]

Return 1 if this class is the same type of (or a subclass of) the named class. Returns 0 otherwise. This method works in combination with vtkTypeRevisionMacro found in vtkSetGet.h.

Reimplemented from vtkObject.

Reimplemented in vtkMySQLQuery, vtkPostgreSQLQuery, vtkSQLiteQuery, and vtkSQLQuery.

static vtkRowQuery* vtkRowQuery::SafeDownCast ( vtkObject o  )  [static]

Reimplemented from vtkObject.

Reimplemented in vtkMySQLQuery, vtkPostgreSQLQuery, vtkSQLiteQuery, and vtkSQLQuery.

void vtkRowQuery::PrintSelf ( ostream &  os,
vtkIndent  indent 
) [virtual]

Methods invoked by print to print information about the object including superclasses. Typically not called by the user (use Print() instead) but used in the hierarchical print process to combine the output of several classes.

Reimplemented from vtkObject.

Reimplemented in vtkMySQLQuery, vtkPostgreSQLQuery, vtkSQLiteQuery, and vtkSQLQuery.

virtual bool vtkRowQuery::Execute (  )  [pure virtual]

Execute the query. This must be performed before any field name or data access functions are used.

Implemented in vtkMySQLQuery, vtkPostgreSQLQuery, vtkSQLiteQuery, and vtkSQLQuery.

virtual int vtkRowQuery::GetNumberOfFields (  )  [pure virtual]

The number of fields in the query result.

Implemented in vtkMySQLQuery, vtkPostgreSQLQuery, and vtkSQLiteQuery.

virtual const char* vtkRowQuery::GetFieldName ( int  i  )  [pure virtual]

Return the name of the specified query field.

Implemented in vtkMySQLQuery, vtkPostgreSQLQuery, and vtkSQLiteQuery.

virtual int vtkRowQuery::GetFieldType ( int  i  )  [pure virtual]

Return the type of the field, using the constants defined in vtkType.h.

Implemented in vtkMySQLQuery, vtkPostgreSQLQuery, and vtkSQLiteQuery.

int vtkRowQuery::GetFieldIndex ( char *  name  ) 

Return the index of the specified query field. Uses GetNumberOfFields() and GetFieldName() to match field name.

virtual bool vtkRowQuery::NextRow (  )  [pure virtual]

Advance row, return false if past end.

Implemented in vtkMySQLQuery, vtkPostgreSQLQuery, and vtkSQLiteQuery.

virtual bool vtkRowQuery::IsActive (  )  [pure virtual]

Return true if the query is active (i.e. execution was successful and results are ready to be fetched). Returns false on error or inactive query.

Implemented in vtkSQLQuery.

bool vtkRowQuery::NextRow ( vtkVariantArray rowArray  ) 

Advance row, return false if past end. Also, fill array with row values.

virtual vtkVariant vtkRowQuery::DataValue ( vtkIdType  c  )  [pure virtual]

Return data in current row, field c

Implemented in vtkMySQLQuery, vtkPostgreSQLQuery, and vtkSQLiteQuery.

virtual bool vtkRowQuery::HasError (  )  [pure virtual]

Returns true if an error is set, otherwise false.

Implemented in vtkMySQLQuery, vtkPostgreSQLQuery, and vtkSQLiteQuery.

virtual const char* vtkRowQuery::GetLastErrorText (  )  [pure virtual]

Get the last error text from the query

Implemented in vtkMySQLQuery, vtkPostgreSQLQuery, and vtkSQLiteQuery.


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

Generated on Sat Dec 27 13:48:09 2008 for VTK by  doxygen 1.5.6