From d796c9dd933ab96ec83b9a634feedd5d32e1ba3f Mon Sep 17 00:00:00 2001 From: Timothy Pearson Date: Tue, 8 Nov 2011 12:31:36 -0600 Subject: Test conversion to TQt3 from Qt3 8c6fc1f8e35fd264dd01c582ca5e7549b32ab731 --- doc/html/qsqldriver.html | 295 +++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 295 insertions(+) create mode 100644 doc/html/qsqldriver.html (limited to 'doc/html/qsqldriver.html') diff --git a/doc/html/qsqldriver.html b/doc/html/qsqldriver.html new file mode 100644 index 000000000..b1fd5306e --- /dev/null +++ b/doc/html/qsqldriver.html @@ -0,0 +1,295 @@ + + + + + +TQSqlDriver Class + + + + + + + +
+ +Home + | +All Classes + | +Main Classes + | +Annotated + | +Grouped Classes + | +Functions +

TQSqlDriver Class Reference
[sql module]

+ +

The TQSqlDriver class is an abstract base class for accessing +SQL databases. +More... +

#include <qsqldriver.h> +

Inherits TQObject. +

List of all member functions. +

Public Members

+ +

Protected Members

+ +

Detailed Description

+ + +The TQSqlDriver class is an abstract base class for accessing +SQL databases. +

+ +

This class should not be used directly. Use TQSqlDatabase instead. +

See also Database Classes. + +

Member Type Documentation

+

TQSqlDriver::DriverFeature

+ +

This enum contains a list of features a driver may support. Use +hasFeature() to query whether a feature is supported or not. +

More information about supported features can be found in the +TQt SQL driver documentation. +

See also hasFeature(). + +

Member Function Documentation

+

TQSqlDriver::TQSqlDriver ( TQObject * parent = 0, const char * name = 0 ) +

+Default constructor. Creates a new driver with parent parent, +called name. +

+

TQSqlDriver::~TQSqlDriver () +

+Destroys the object and frees any allocated resources. + +

bool TQSqlDriver::beginTransaction () [virtual] +

+Protected function which derived classes can reimplement to begin +a transaction. If successful, return TRUE, otherwise return FALSE. +The default implementation returns FALSE. +

See also commitTransaction() and rollbackTransaction(). + +

void TQSqlDriver::close () [pure virtual] +

+ +

Derived classes must reimplement this abstract virtual function in +order to close the database connection. Return TRUE on success, +FALSE on failure. +

See also setOpen(). + +

+

bool TQSqlDriver::commitTransaction () [virtual] +

+Protected function which derived classes can reimplement to commit +a transaction. If successful, return TRUE, otherwise return FALSE. +The default implementation returns FALSE. +

See also beginTransaction() and rollbackTransaction(). + +

TQSqlQuery TQSqlDriver::createQuery () const [pure virtual] +

+ +

Creates an empty SQL result on the database. Derived classes must +reimplement this function and return a TQSqlQuery object +appropriate for their database to the caller. +

+

TQString TQSqlDriver::formatValue ( const TQSqlField * field, bool trimStrings = FALSE ) const [virtual] +

+Returns a string representation of the field value for the +database. This is used, for example, when constructing INSERT and +UPDATE statements. +

The default implementation returns the value formatted as a string +according to the following rules: +

+

See also TQVariant::toString(). + +

+

bool TQSqlDriver::hasFeature ( DriverFeature f ) const [pure virtual] +

+ +

Returns TRUE if the driver supports feature f; otherwise +returns FALSE. +

Note that some databases need to be open() before this can be +determined. +

See also DriverFeature. + +

bool TQSqlDriver::isOpen () const +

+Returns TRUE if the database connection is open; otherwise returns +FALSE. + +

bool TQSqlDriver::isOpenError () const +

+Returns TRUE if the there was an error opening the database +connection; otherwise returns FALSE. + +

TQSqlError TQSqlDriver::lastError () const +

+Returns a TQSqlError object which contains information about the +last error that occurred on the database. + +

TQString TQSqlDriver::nullText () const [virtual] +

+Returns a string representation of the NULL value for the +database. This is used, for example, when constructing INSERT and +UPDATE statements. The default implementation returns the string +"NULL". + +

bool TQSqlDriver::open ( const TQString & db, const TQString & user = TQString::null, const TQString & password = TQString::null, const TQString & host = TQString::null, int port = -1 ) [pure virtual] +

+ +

Derived classes must reimplement this abstract virtual function in +order to open a database connection on database db, using user +name user, password password, host host and port port. +

The function must return TRUE on success and FALSE on failure. +

See also setOpen(). + +

+

bool TQSqlDriver::open ( const TQString & db, const TQString & user, const TQString & password, const TQString & host, int port, const TQString & connOpts ) +

+This is an overloaded member function, provided for convenience. It behaves essentially like the above function. +

Open a database connection on database db, using user name user, password password, host host, port port and +connection options connOpts. +

Returns TRUE on success and FALSE on failure. +

See also setOpen(). + +

TQSqlIndex TQSqlDriver::primaryIndex ( const TQString & tableName ) const [virtual] +

+Returns the primary index for table tableName. Returns an empty +TQSqlIndex if the table doesn't have a primary index. The default +implementation returns an empty index. + +

TQSqlRecord TQSqlDriver::record ( const TQString & tableName ) const [virtual] +

+Returns a TQSqlRecord populated with the names of the fields in +table tableName. If no such table exists, an empty record is +returned. The default implementation returns an empty record. + +

TQSqlRecord TQSqlDriver::record ( const TQSqlQuery & query ) const [virtual] +

+This is an overloaded member function, provided for convenience. It behaves essentially like the above function. +

Returns a TQSqlRecord populated with the names of the fields in the +SQL query. The default implementation returns an empty record. + +

TQSqlRecordInfo TQSqlDriver::recordInfo ( const TQString & tablename ) const [virtual] +

+Returns a TQSqlRecordInfo object with meta data about the table tablename. + +

TQSqlRecordInfo TQSqlDriver::recordInfo ( const TQSqlQuery & query ) const [virtual] +

+This is an overloaded member function, provided for convenience. It behaves essentially like the above function. +

Returns a TQSqlRecordInfo object with meta data for the TQSqlQuery +query. Note that this overloaded function may return less +information than the recordInfo() function which takes the name of +a table as parameter. + +

bool TQSqlDriver::rollbackTransaction () [virtual] +

+Protected function which derived classes can reimplement to +rollback a transaction. If successful, return TRUE, otherwise +return FALSE. The default implementation returns FALSE. +

See also beginTransaction() and commitTransaction(). + +

void TQSqlDriver::setLastError ( const TQSqlError & e ) [virtual protected] +

+Protected function which allows derived classes to set the value +of the last error, e, that occurred on the database. +

See also lastError(). + +

void TQSqlDriver::setOpen ( bool o ) [virtual protected] +

+Protected function which sets the open state of the database to o. Derived classes can use this function to report the status of +open(). +

See also open() and setOpenError(). + +

void TQSqlDriver::setOpenError ( bool e ) [virtual protected] +

+Protected function which sets the open error state of the database +to e. Derived classes can use this function to report the +status of open(). Note that if e is TRUE the open state of the +database is set to closed (i.e. isOpen() returns FALSE). +

See also open(). + +

TQStringList TQSqlDriver::tables ( const TQString & tableType ) const [virtual] +

+Returns a list of tables in the database. The default +implementation returns an empty list. +

The tableType argument describes what types of tables +should be returned. Due to binary compatibility, the string +contains the value of the enum TQSql::TableTypes as text. +An empty string should be treated as TQSql::Tables for +downward compatibility. +

See also TQSql::TableType. + + +

+This file is part of the TQt toolkit. +Copyright © 1995-2007 +Trolltech. All Rights Reserved.

+ +
Copyright © 2007 +TrolltechTrademarks +
TQt 3.3.8
+
+ -- cgit v1.2.1