diff options
Diffstat (limited to 'doc/html/sql-driver.html')
| -rw-r--r-- | doc/html/sql-driver.html | 54 |
1 files changed, 27 insertions, 27 deletions
diff --git a/doc/html/sql-driver.html b/doc/html/sql-driver.html index 2838e34eb..e6f6b3d50 100644 --- a/doc/html/sql-driver.html +++ b/doc/html/sql-driver.html @@ -121,7 +121,7 @@ client libraries (>3.23.34) allow you to use transactions on those modified servers. <p> If you have a recent client library and connect to a transaction-enabled MySQL server, a call to the -<a href="qsqldriver.html#hasFeature">TQSqlDriver::hasFeature</a>( TQSqlDriver::Transactions ) function returns +<a href="ntqsqldriver.html#hasFeature">TQSqlDriver::hasFeature</a>( TQSqlDriver::Transactions ) function returns TRUE and SQL transactions can be used. <p> If the plugin is compiled against MySQL 4.x client libraries, transactions are enabled by default. @@ -172,15 +172,15 @@ encoding to communicate with the server. that this process may require a lot of memory. <p> Note that Oracle 9 doesn't support scrollable result sets with LOB columns, you have to use a forward only query to select LOB fields -(see <a href="qsqlquery.html#setForwardOnly">TQSqlQuery::setForwardOnly</a>()). +(see <a href="ntqsqlquery.html#setForwardOnly">TQSqlQuery::setForwardOnly</a>()). <p> Inserting BLOBs should be done using either a prepared query where the -BLOBs are bound to placeholders, or <a href="qsqlcursor.html">TQSqlCursor</a> which uses a prepared +BLOBs are bound to placeholders, or <a href="ntqsqlcursor.html">TQSqlCursor</a> which uses a prepared query to do this internally (see $QTDIR/examples/sql/blob). <p> <h4> Know problems </h4> -<a name="3-2-4"></a><p> When a query is in forward only mode a call to <a href="qsqlquery.html#last">TQSqlQuery::last</a>() will +<a name="3-2-4"></a><p> When a query is in forward only mode a call to <a href="ntqsqlquery.html#last">TQSqlQuery::last</a>() will position the query on the last record and return TRUE, but subsequent -calls to <a href="qsqlquery.html#value">TQSqlQuery::value</a>() will only return NULLs. +calls to <a href="ntqsqlquery.html#value">TQSqlQuery::value</a>() will only return NULLs. <p> <h4> How to build the plugin on Unix/Linux </h4> <a name="3-2-5"></a><p> All files required to build driver should ship with the standard Oracle @@ -260,7 +260,7 @@ be installed first. Note that every client that uses your application is required to have an ODBC driver manager installed, otherwise the TQODBC3 plugin will not work. <p> Be aware that when connecting to an ODBC datasource you must pass in -the name of the ODBC datasource to the <a href="qsqldatabase.html#setDatabaseName">TQSqlDatabase::setDatabaseName</a>() +the name of the ODBC datasource to the <a href="ntqsqldatabase.html#setDatabaseName">TQSqlDatabase::setDatabaseName</a>() function: not the actual database name. <p> The TQODBC3 Plugin needs an ODBC compliant driver manager version 2.0 or later to work. Some ODBC drivers claim to be version 2.0 compliant, @@ -422,7 +422,7 @@ files necessary for compiling the TQDB2 plugin. <p> The TQDB2 driver supports prepared queries, reading/writing of Unicode strings and reading/writing of BLOBs. <p> We suggest using a forward-only query when calling stored procedures -in DB2 (see <a href="qsqlquery.html#setForwardOnly">TQSqlQuery::setForwardOnly</a>()). +in DB2 (see <a href="ntqsqlquery.html#setForwardOnly">TQSqlQuery::setForwardOnly</a>()). <p> <h4> How to build the plugin on Unix/Linux </h4> <a name="3-6-2"></a><p> <pre> @@ -559,16 +559,16 @@ error message. <p> <a name="development"></a> <h2> How to write your own database driver </h2> -<a name="5"></a><p> <a href="qsqldatabase.html">TQSqlDatabase</a> is responsible for loading and managing database driver -plugins. When a database is added (see <a href="qsqldatabase.html#addDatabase">TQSqlDatabase::addDatabase</a>()), -the appropriate driver plugin is loaded (using <a href="qsqldriverplugin.html">TQSqlDriverPlugin</a>). +<a name="5"></a><p> <a href="ntqsqldatabase.html">TQSqlDatabase</a> is responsible for loading and managing database driver +plugins. When a database is added (see <a href="ntqsqldatabase.html#addDatabase">TQSqlDatabase::addDatabase</a>()), +the appropriate driver plugin is loaded (using <a href="ntqsqldriverplugin.html">TQSqlDriverPlugin</a>). TQSqlDatabase relies on the driver plugin to provide interfaces for -<a href="qsqldriver.html">TQSqlDriver</a> and <a href="qsqlresult.html">TQSqlResult</a>. +<a href="ntqsqldriver.html">TQSqlDriver</a> and <a href="ntqsqlresult.html">TQSqlResult</a>. <p> TQSqlDriver is an abstract base class which defines the functionality of a SQL database driver. This includes functions such as -<a href="qsqldriver.html#open">TQSqlDriver::open</a>() and <a href="qsqldriver.html#close">TQSqlDriver::close</a>(). TQSqlDriver is responsible +<a href="ntqsqldriver.html#open">TQSqlDriver::open</a>() and <a href="ntqsqldriver.html#close">TQSqlDriver::close</a>(). TQSqlDriver is responsible for connecting to a database, establish the proper environment, etc. -In addition, TQSqlDriver can create <a href="qsqlquery.html">TQSqlQuery</a> objects appropriate for +In addition, TQSqlDriver can create <a href="ntqsqlquery.html">TQSqlQuery</a> objects appropriate for the particular database API. TQSqlDatabase forwards many of its function calls directly to TQSqlDriver which provides the concrete implementation. @@ -577,9 +577,9 @@ of a SQL database query. This includes statements such as <tt>SELECT</tt>, <tt>UPDATE</tt>, and <tt>ALTER TABLE</tt>. TQSqlResult contains functions such as TQSqlResult::next() and TQSqlResult::value(). TQSqlResult is responsible for sending queries to the database, returning result data, etc. -TQSqlQuery forwards many of its function calls directly to <a href="qsqlresult.html">TQSqlResult</a> +TQSqlQuery forwards many of its function calls directly to <a href="ntqsqlresult.html">TQSqlResult</a> which provides the concrete implementation. -<p> <a href="qsqldriver.html">TQSqlDriver</a> and TQSqlResult are closely connected. When implementing a +<p> <a href="ntqsqldriver.html">TQSqlDriver</a> and TQSqlResult are closely connected. When implementing a TQt SQL driver, both of these classes must to be subclassed and the abstract virtual methods in each class must be implemented. <p> To implement a TQt SQL driver as a plugin (so that it is recognized and @@ -591,36 +591,36 @@ with TQt in <tt>QTDIR/plugins/src/sqldrivers</tt> and <tt>QTDIR/src/sql/drivers</tt>. <p> The following code can be used as a skeleton for a SQL driver: <p> <pre> -class TQNullResult : public <a href="qsqlresult.html">TQSqlResult</a> +class TQNullResult : public <a href="ntqsqlresult.html">TQSqlResult</a> { public: - TQNullResult( const <a href="qsqldriver.html">TQSqlDriver</a>* d ): <a href="qsqlresult.html">TQSqlResult</a>( d ) {} + TQNullResult( const <a href="ntqsqldriver.html">TQSqlDriver</a>* d ): <a href="ntqsqlresult.html">TQSqlResult</a>( d ) {} ~TQNullResult() {} protected: - <a href="qvariant.html">TQVariant</a> data( int ) { return TQVariant(); } - bool reset ( const <a href="qstring.html">TQString</a>& ) { return FALSE; } + <a href="ntqvariant.html">TQVariant</a> data( int ) { return TQVariant(); } + bool reset ( const <a href="ntqstring.html">TQString</a>& ) { return FALSE; } bool fetch( int ) { return FALSE; } bool fetchFirst() { return FALSE; } bool fetchLast() { return FALSE; } bool isNull( int ) { return FALSE; } - <a href="qsqlrecord.html">TQSqlRecord</a> record() { return TQSqlRecord(); } + <a href="ntqsqlrecord.html">TQSqlRecord</a> record() { return TQSqlRecord(); } int size() { return 0; } int numRowsAffected() { return 0; } }; -class TQNullDriver : public <a href="qsqldriver.html">TQSqlDriver</a> +class TQNullDriver : public <a href="ntqsqldriver.html">TQSqlDriver</a> { public: - TQNullDriver(): <a href="qsqldriver.html">TQSqlDriver</a>() {} + TQNullDriver(): <a href="ntqsqldriver.html">TQSqlDriver</a>() {} ~TQNullDriver() {} bool hasFeature( DriverFeature ) const { return FALSE; } - bool open( const <a href="qstring.html">TQString</a>&, - const <a href="qstring.html">TQString</a>&, - const <a href="qstring.html">TQString</a>&, - const <a href="qstring.html">TQString</a>&, + bool open( const <a href="ntqstring.html">TQString</a>&, + const <a href="ntqstring.html">TQString</a>&, + const <a href="ntqstring.html">TQString</a>&, + const <a href="ntqstring.html">TQString</a>&, int ) { return FALSE; } void close() {} - <a href="qsqlquery.html">TQSqlQuery</a> createQuery() const { return TQSqlQuery( new TQNullResult( this ) ); } + <a href="ntqsqlquery.html">TQSqlQuery</a> createQuery() const { return TQSqlQuery( new TQNullResult( this ) ); } }; </pre> |