vtkSQLiteQuery Class Reference

#include <vtkSQLiteQuery.h>

Inheritance diagram for vtkSQLiteQuery:

[legend]

Collaboration diagram for vtkSQLiteQuery:

[legend]

List of all members.

Detailed Description

vtkSQLQuery implementation for SQLite databases

This is an implementation of vtkSQLQuery for SQLite databases. See the documentation for vtkSQLQuery for information about what the methods do.

Bug:: Sometimes Execute() will return false (meaning an error) but GetLastErrorText() winds up null. I am not certain why this is happening.

Thanks:: Thanks to Andrew Wilson from Sandia National Laboratories for implementing this class.

See also:: vtkSQLDatabase vtkSQLQuery vtkSQLiteDatabase

Definition at line 53 of file vtkSQLiteQuery.h.


Public Types
typedef vtkSQLQuery	Superclass
Public Member Functions
virtual const char *	GetClassName ()
virtual int	IsA (const char *type)
void	PrintSelf (ostream &os, vtkIndent indent)
bool	SetQuery (const char *query)
bool	Execute ()
int	GetNumberOfFields ()
const char *	GetFieldName (int i)
int	GetFieldType (int i)
bool	NextRow ()
bool	HasError ()
vtkVariant	DataValue (vtkIdType c)
const char *	GetLastErrorText ()

bool	BeginTransaction ()
bool	RollbackTransaction ()
bool	CommitTransaction ()

bool	BindParameter (int index, unsigned char value)
bool	BindParameter (int index, signed char value)
bool	BindParameter (int index, unsigned short value)
bool	BindParameter (int index, short value)
bool	BindParameter (int index, unsigned int value)
bool	BindParameter (int index, int value)
bool	BindParameter (int index, unsigned long value)
bool	BindParameter (int index, long value)
bool	BindParameter (int index, vtkTypeUInt64 value)
bool	BindParameter (int index, vtkTypeInt64 value)
bool	BindParameter (int index, float value)
bool	BindParameter (int index, double value)
bool	BindParameter (int index, const char *stringValue)
bool	BindParameter (int index, const char *stringValue, size_t length)
bool	BindParameter (int index, const vtkStdString &string)
bool	BindParameter (int index, vtkVariant value)
bool	BindParameter (int index, const void *data, size_t length)
bool	ClearParameterBindings ()
Static Public Member Functions
static int	IsTypeOf (const char *type)
static vtkSQLiteQuery *	SafeDownCast (vtkObject *o)
static vtkSQLiteQuery *	New ()
Protected Member Functions
	vtkSQLiteQuery ()
	~vtkSQLiteQuery ()
virtual void	SetLastErrorText (const char *)
Friends
class	vtkSQLiteDatabase

Member Typedef Documentation

typedef vtkSQLQuery vtkSQLiteQuery::Superclass

Reimplemented from vtkSQLQuery.

Definition at line 60 of file vtkSQLiteQuery.h.

Constructor & Destructor Documentation

vtkSQLiteQuery::vtkSQLiteQuery ( ) [protected]

vtkSQLiteQuery::~vtkSQLiteQuery ( ) [protected]

Member Function Documentation

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

Reimplemented from vtkSQLQuery.

static int vtkSQLiteQuery::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 vtkTypeMacro found in vtkSetGet.h.

Reimplemented from vtkSQLQuery.

virtual int vtkSQLiteQuery::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 vtkTypeMacro found in vtkSetGet.h.

Reimplemented from vtkSQLQuery.

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

Reimplemented from vtkSQLQuery.

void vtkSQLiteQuery::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 vtkSQLQuery.

static vtkSQLiteQuery* vtkSQLiteQuery::New ( ) [static]

Create an object with Debug turned off, modified time initialized to zero, and reference counting on.

Reimplemented from vtkObject.

bool vtkSQLiteQuery::SetQuery ( const char * query ) [virtual]

Set the SQL query string. This must be performed before Execute() or BindParameter() can be called.

Reimplemented from vtkSQLQuery.

bool vtkSQLiteQuery::Execute ( ) [virtual]

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

Implements vtkSQLQuery.

int vtkSQLiteQuery::GetNumberOfFields ( ) [virtual]

The number of fields in the query result.

Implements vtkRowQuery.

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

Return the name of the specified query field.

Implements vtkRowQuery.

int vtkSQLiteQuery::GetFieldType ( int i ) [virtual]

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

Implements vtkRowQuery.

bool vtkSQLiteQuery::NextRow ( ) [virtual]

Advance row, return false if past end.

Implements vtkRowQuery.

bool vtkSQLiteQuery::HasError ( ) [virtual]

Return true if there is an error on the current query.

Implements vtkRowQuery.

bool vtkSQLiteQuery::BeginTransaction ( ) [virtual]

Begin, abort (roll back), or commit a transaction.

Reimplemented from vtkSQLQuery.

bool vtkSQLiteQuery::RollbackTransaction ( ) [virtual]

Begin, abort (roll back), or commit a transaction.

Reimplemented from vtkSQLQuery.

bool vtkSQLiteQuery::CommitTransaction ( ) [virtual]

Begin, abort (roll back), or commit a transaction.

Reimplemented from vtkSQLQuery.

vtkVariant vtkSQLiteQuery::DataValue ( vtkIdType c ) [virtual]

Return data in current row, field c

Implements vtkRowQuery.

const char* vtkSQLiteQuery::GetLastErrorText ( ) [virtual]

Get the last error text from the query

Implements vtkRowQuery.

bool vtkSQLiteQuery::BindParameter	(	int	index,
		unsigned char	value
	)			`[virtual]`

Bind a parameter to a placeholder in a query. A full discussion of this feature is beyond the scope of this header file, but in short, here's how it works: Instead of saying "SELECT foo FROM mytable WHERE myfield = 12345" you can say "SELECT foo FROM mytable WHERE myfield = ?". The ? character is a placeholder for a parameter that must then be bound. Call BindParameter(0, 12345) to bind the integer value 12345 to that field. Placeholders are indexed starting at 0. You are responsible for making sure that the types match when you call BindParameter. You don't have to get it precisely correct: in general, the SQL driver is smart enough to do things like cast a short to a long or a float to a double. Bound parameters were introduced in ANSI SQL 92. Please see that standard for more information. Most of these methods are excluded from wrapping because the Java wrapper treats all integer types from char up through 64-bit long as 'int'. This is incorrect behavior but what else am I going to do? Finally, the default implementation for BindParameter(int, vtkVariant) dispatches to one of the more type-specific versions. It should be OK to use in database drivers without modification.

Reimplemented from vtkSQLQuery.

bool vtkSQLiteQuery::BindParameter	(	int	index,
		signed char	value
	)			`[virtual]`

Reimplemented from vtkSQLQuery.

bool vtkSQLiteQuery::BindParameter	(	int	index,
		unsigned short	value
	)			`[virtual]`

Reimplemented from vtkSQLQuery.

bool vtkSQLiteQuery::BindParameter	(	int	index,
		short	value
	)			`[virtual]`

Reimplemented from vtkSQLQuery.

bool vtkSQLiteQuery::BindParameter	(	int	index,
		unsigned int	value
	)			`[virtual]`

Reimplemented from vtkSQLQuery.

bool vtkSQLiteQuery::BindParameter	(	int	index,
		int	value
	)			`[virtual]`

Reimplemented from vtkSQLQuery.

bool vtkSQLiteQuery::BindParameter	(	int	index,
		unsigned long	value
	)			`[virtual]`

Reimplemented from vtkSQLQuery.

bool vtkSQLiteQuery::BindParameter	(	int	index,
		long	value
	)			`[virtual]`

Reimplemented from vtkSQLQuery.

bool vtkSQLiteQuery::BindParameter	(	int	index,
		vtkTypeUInt64	value
	)			`[virtual]`

Reimplemented from vtkSQLQuery.

bool vtkSQLiteQuery::BindParameter	(	int	index,
		vtkTypeInt64	value
	)			`[virtual]`

Reimplemented from vtkSQLQuery.

bool vtkSQLiteQuery::BindParameter	(	int	index,
		float	value
	)			`[virtual]`

Reimplemented from vtkSQLQuery.

bool vtkSQLiteQuery::BindParameter	(	int	index,
		double	value
	)			`[virtual]`

Reimplemented from vtkSQLQuery.

bool vtkSQLiteQuery::BindParameter	(	int	index,
		const char *	stringValue
	)			`[virtual]`