qsqlquery.html

来自「QT 下载资料仅供参考」· HTML 代码 · 共 270 行 · 第 1/2 页

</h3> 
返回一个指向与查询对应的数据库驱动的指针。

<h3 class=fn>bool <a name="exec"></a>QSqlQuery::exec ( const&nbsp;<a href="qstring.html">QString</a>&nbsp;&amp;&nbsp;query )<tt> [virtual]</tt>
</h3> 
执行 SQL <em>query</em>。如果查询成功了便设置查询的状态为活动，并且返回TRUE。否则返回false并且查询变为非活动状态。 <em>query</em> 语句必须必须符合数据数据库的语法要求，比如说，标准的SQL。
<p> 执行之后，查询被定位在一个无效的记录上，所以在获得数据之前，必须先导航到一个有效的记录上。
<p> 注意：执行exec()之后，查询的最后错误会被得新设置。
<p> <p>也可以参考 <a href="#isActive">isActive</a>()、<a href="#isValid">isValid</a>()、<a href="#next">next</a>()、<a href="#prev">prev</a>()、<a href="#first">first</a>()、<a href="#last">last</a>() 和 <a href="#seek">seek</a>()。
<p>例子： <a href="sql.html#x2208">sql/overview/basicbrowsing/main.cpp</a>、<a href="sql.html#x2212">sql/overview/basicbrowsing2/main.cpp</a> 和 <a href="sql.html#x2217">sql/overview/basicdatamanip/main.cpp</a>。

<h3 class=fn>bool <a name="first"></a>QSqlQuery::first ()<tt> [virtual]</tt>
</h3> 检索结果集中的第一个记录，如果有效的话，还将定位查询在检索的记录上。注意，在调用这个函数之前，结果集必须处于一个有效的状态，并且 <a href="#isSelect">isSelect</a>() 必须返回TRUE，否则它将什么都不做，返回FALSE。成功执行返回TRUE。如果不成功，查询被设置到一个无效的位置上，并返回FALSE。
<p>例子： <a href="sql.html#x2221">sql/overview/navigating/main.cpp</a>。

<h3 class=fn>bool <a name="isActive"></a>QSqlQuery::isActive () const
</h3>  
如果查询当前是处于一个活动的状态返回 TRUE，否则返回 FALSE。
<p>例子：<a href="sql.html#x2209">sql/overview/basicbrowsing/main.cpp</a>、<a href="sql.html#x2213">sql/overview/basicbrowsing2/main.cpp</a>、<a href="sql.html#x2218">sql/overview/basicdatamanip/main.cpp</a>、<a href="sql.html#x2222">sql/overview/navigating/main.cpp</a> 和 <a href="sql.html#x2226">sql/overview/retrieve1/main.cpp</a>。

<h3 class=fn>bool <a name="isNull"></a>QSqlQuery::isNull ( int&nbsp;field ) const
</h3>  
如果<em>field</em> 当前为 NULL 返回，否则返回 FALSE 。在调用这个函数之前，查询必须是活动的并且被定位在一个有效的记录上，否则将返回 FALSE 。注意，对于一些驱动来说，<a href="#isNull">isNull</a>() 不会返回准确的信息，直到尝试去检索数据。
<p> <p>也可以参考  <a href="#isActive">isActive</a>()、<a href="#isValid">isValid</a>() 和 <a href="#value">value</a>()。

<h3 class=fn>bool <a name="isSelect"></a>QSqlQuery::isSelect () const
</h3>  
如果当前的查询是 SELECT 语句返回TRUE，否则返回 FALSE。

<h3 class=fn>bool <a name="isValid"></a>QSqlQuery::isValid () const
</h3> 
如果查询当前处在一个有效的记录上返回TRUE，否则返回FALSE。

<h3 class=fn>bool <a name="last"></a>QSqlQuery::last ()<tt> [virtual]</tt>
</h3> R检索结果集中的最后一个记录，如果有效的话，将定位查询在检索的记录上。注意，在调用这个函数之前，结果集必须处于有效的状态，而且 <a href="#isSelect">isSelect</a>() 必须返回 TRUE。否则它将什么都不做还返回 FALSE。如果成功将返回 TRUE。如果失败查询被定位到一个无效的位置上并且返回FALSE。 
<p>例子：<a href="sql.html#x2223">sql/overview/navigating/main.cpp</a>。

<h3 class=fn><a href="qsqlerror.html">QSqlError</a> <a name="lastError"></a>QSqlQuery::lastError () const
</h3>  
返回最后产生的错误信息。
<p> <p>也可以参考 <a href="qsqlerror.html">QSqlError</a>。

<h3 class=fn><a href="qstring.html">QString</a> <a name="lastQuery"></a>QSqlQuery::lastQuery () const
</h3> 
返回当前正被使用的查询的文本，如果没有查询文本则返回 <a href="qstring.html#QString-null">QString::null</a>。

<h3 class=fn>bool <a name="next"></a>QSqlQuery::next ()<tt> [virtual]</tt>
</h3> 在结果集中检索下一个记录，如果有效，定位查询在被检索的记录上。注意，在调用这个函数之前，结果集必须处于有效的状态，而且 <a href="#isSelect">isSelect</a>() 必须返回 TRUE。否则它将什么都不做返回 FALSE。
<p> 应用以下一些规则：
<p> <ul>
<li>如果如果集被定位在第一个记录之前，刚刚执行完一个查询就处于这种状态，那么可以用此函数来检索第一个记录。
<li>如果如果集被定位在最后一个记录之后，那么什么都不会改变，返回FALSE。
<li> 如果结果集被定位在中间，此函数可以检索下一个记录。
</ul>
<p> 如果记录不能被检索，结果集将被定位在最后一个记录之后，并返回 FALSE 。如果记录成功检索，那么返回 TRUE 。
<p> <p>也可以参考 <a href="#at">at</a>()和<a href="#isValid">isValid</a>()。
<p>例子： <a href="sql.html#x2210">sql/overview/basicbrowsing/main.cpp</a>、<a href="sql.html#x2214">sql/overview/basicbrowsing2/main.cpp</a>、<a href="sql.html#x2227">sql/overview/retrieve1/main.cpp</a>、<a href="sql.html#x2312">sql/overview/subclass3/main.cpp</a>、<a href="sql.html#x2316">sql/overview/subclass4/main.cpp</a>、<a href="sql.html#x2319">sql/overview/subclass5/main.cpp</a>和<a href="sqltable-example.html#x2564">sql/sqltable/main.cpp</a>。

<h3 class=fn>int <a name="numRowsAffected"></a>QSqlQuery::numRowsAffected () const
</h3>  
返回有多少行记录被结果集的 SQL 语句影响了，如果不能确定将返回 -1 。注意，对于 SELECT语句，此值等同于 <a href="#size">size</a>()如果查询处于非活动状态（<a href="#isActive">isActive</a>()返回FALSE），将反回 -1。
<p> <p>也可以参考 <a href="#size">size</a>() 和 <a href="qsqldriver.html#hasFeature">QSqlDriver::hasFeature</a>()。
<p>例子： <a href="sql.html#x2215">sql/overview/basicbrowsing2/main.cpp</a> 和 <a href="sql.html#x2219">sql/overview/basicdatamanip/main.cpp</a>。

<h3 class=fn><a href="qsqlquery.html">QSqlQuery</a>&nbsp;&amp; <a name="operator-eq"></a>QSqlQuery::operator= ( const&nbsp;<a href="qsqlquery.html">QSqlQuery</a>&nbsp;&amp;&nbsp;other )
</h3>
分配<em>other</em> 给查询。

<h3 class=fn>bool <a name="prev"></a>QSqlQuery::prev ()<tt> [virtual]</tt>
</h3> 在结果集中检索前一个记录，如果有效，查询被这位在检索的记录上。注意，在调用这个函数之前，结果集必须处于有效的状态，而且 <a href="#isSelect">isSelect</a>() 必须返回 TRUE。否则它将什么都不做返回 FALSE。
<p> 应用以下一些规则：
<p> <ul>
<li>如果结果集被定位在第一个记录之前，什么都不会改变，返回 FALSE。
<li>如果结果集被定位在最后一个记录之后，调用此函数可以检索到最后一个记录。
<li>如果结果集被定位在中间位置，调用此函数可以检索前一个记录。
</ul>
<p> 如果记录不能被检索，结果集将被定位在第一个记录之前，并返回 FALSE 。如果记录成功检索，那么返回 TRUE 。
<p> <p>也可以参考 <a href="#at">at</a>()。

<h3 class=fn>const&nbsp;<a href="qsqlresult.html">QSqlResult</a>&nbsp;* <a name="result"></a>QSqlQuery::result () const
</h3> 
返回查询对应的指针。

<h3 class=fn>bool <a name="seek"></a>QSqlQuery::seek ( int&nbsp;i, bool&nbsp;relative = FALSE )<tt> [virtual]</tt>
</h3> 
检索位置为 <em>i</em>（偏移） 的记录，如果有效，查询被定位在检索的记录上。第一个记录在位置0上。注意，在调用这个函数之前，查询必须处于活动状态，而且
<a href="#isSelect">isSelect</a>() 必须返回TRUE。
<p> 应用以下一些规则：
<p> 如果 <em>relative</em>  为FALSE（默认）, 应用以下规则：
<p> <ul>
<li> 如果<em>i</em> 是负的，结果集被定位在第一个记录之前，并返回 FALSE。
<li> 否则，将定位查询到位置
<em>i</em> 。如果位置 <em>i</em> 上的记录不能被检索，结果集被定位到最后一个记录之后返回FALSE。如果记录被成功检索，返回TRUE。
</ul>
<p> 如果 <em>relative</em>为TRUE，应用以下规则：
<p> <ul>
<li> 如果结果集当前处于第一个记录之前，或者就在第一个记录之上，而且 <em>i</em> 是负的，那么什么都不会改变，FALSE 将被返回。
<li> 如果结果集处于在最后一个记录之后，而且 
<em>i</em> 是负的，那么什么都不改变，返回 FALSE。
<li>如果结果集处于中间的某个位置，相对偏移量 <em>i</em>  移动结果集在0 之下，那么结果集将定位在第一个记录之前，返回FALSE。
<li> 否则，调用此函数将向前移动结果集到记录 <em>i</em> （或者向后移动到记录<em>i</em>如果<em>i</em>
是负的）。如果记录偏移量 <em>i</em>不能被检索，当那么<em>i</em> >=0时，结果集将被定位在最后一个记录之后（或者当<em>i</em>是负时，在第一个记录之前），返回 FALSE。如果记录成功检索，返回TRUE。
</ul>
<p>例子： <a href="sql.html#x2224">sql/overview/navigating/main.cpp</a>。

<h3 class=fn>int <a name="size"></a>QSqlQuery::size () const
</h3>  
返回结果集的大小，（多少行被返回），如果大小不能确定或者数据库不支持报告查询大小的信息时返回-1。注意，对于那些非 SELECT 语句（<a href="#isSelect">isSelect</a>()返回FALSE）， <a href="#size">size</a>() 将返回 -1，如果查询处于非活动状态（<a href="#isActive">isActive</a>()返回FALSE），将返回-1。
<p> 想得一个非 SELECT 语句影响的行数，用 <a href="#numRowsAffected">numRowsAffected</a>()。
<p> <p>也可以参考  <a href="#isActive">isActive</a>()、<a href="#numRowsAffected">numRowsAffected</a>() 和 <a href="qsqldriver.html#hasFeature">QSqlDriver::hasFeature</a>()。
<p>例子 <a href="sql.html#x2225">sql/overview/navigating/main.cpp</a>。

<h3 class=fn><a href="qvariant.html">QVariant</a> <a name="value"></a>QSqlQuery::value ( int&nbsp;i ) const<tt> [virtual]</tt>
</h3> 
返回域  <em>i</em> 的值（基于0）。
<p> 用<tt>SELECT</tt> 语句的文本，域被从左到右编号，比如：在"select forename, surname from people"，域0是forename 而域1 是surname。推荐使用 
<tt>SELECT *</tt> * 语句，因为这样的话查询中的域没有定义。
<p>如果域 <em>i</em> 不存在的话，如果查询处于非活动状态，或查询被定位在一个无效的记录上，一个无效的<a href="qvariant.html">QVariant被返回。
<p> <p>也可以参考 <a href="#prev">prev</a>()、<a href="#next">next</a>()、<a href="#first">first</a>()、<a href="#last">last</a>()、<a href="#seek">seek</a>()、<a href="#isActive">isActive</a>()和<a href="#isValid">isValid</a>()。
<p>例子： <a href="sql.html#x2211">sql/overview/basicbrowsing/main.cpp</a>、<a href="sql.html#x2216">sql/overview/basicbrowsing2/main.cpp</a>、<a href="sql.html#x2228">sql/overview/retrieve1/main.cpp</a>、<a href="sql.html#x2313">sql/overview/subclass3/main.cpp</a>、<a href="sql.html#x2317">sql/overview/subclass4/main.cpp</a>、<a href="sql.html#x2320">sql/overview/subclass5/main.cpp</a>和<a href="sqltable-example.html#x2565">sql/sqltable/main.cpp</a>。

<!-- eof -->
<hr><p>
这个文件是<a href="index.html">Qt工具包</a>一部分。
版权所有 &copy; 1995-2002
<a href="http://www.trolltech.com/">Trolltech</a>。保留所有权利。
<p><address><hr><div align=center>
<table width=100% cellspacing=0 border=0><tr>
<td>Copyright &copy; 2002 
<a href="http://www.trolltech.com">Trolltech</a>
<td><a href="http://www.trolltech.com/trademarks.html">Trademarks</a>
<td><a href="zh_CN.html">译者:tipy</a>
<td align=right><div align=right>Qt 3.0.5版</div>
</table></div></address></body>
</html>