summaryrefslogtreecommitdiffstats
path: root/doc/html/tqsqlcursor.html
diff options
context:
space:
mode:
Diffstat (limited to 'doc/html/tqsqlcursor.html')
-rw-r--r--doc/html/tqsqlcursor.html114
1 files changed, 57 insertions, 57 deletions
diff --git a/doc/html/tqsqlcursor.html b/doc/html/tqsqlcursor.html
index f88598a43..45c6f3674 100644
--- a/doc/html/tqsqlcursor.html
+++ b/doc/html/tqsqlcursor.html
@@ -39,12 +39,12 @@ tables and views.
<p><a href="tqsqlcursor-members.html">List of all member functions.</a>
<h2>Public Members</h2>
<ul>
-<li class=fn><a href="#TQSqlCursor"><b>TQSqlCursor</b></a> ( const&nbsp;TQString&nbsp;&amp;&nbsp;name = TQString::null, bool&nbsp;autopopulate = TRUE, TQSqlDatabase&nbsp;*&nbsp;db = 0 )</li>
+<li class=fn><a href="#TQSqlCursor"><b>TQSqlCursor</b></a> ( const&nbsp;TQString&nbsp;&amp;&nbsp;name = TQString::null, bool&nbsp;autopopulate = true, TQSqlDatabase&nbsp;*&nbsp;db = 0 )</li>
<li class=fn><a href="#TQSqlCursor-2"><b>TQSqlCursor</b></a> ( const&nbsp;TQSqlCursor&nbsp;&amp;&nbsp;other )</li>
<li class=fn>TQSqlCursor &amp; <a href="#operator-eq"><b>operator=</b></a> ( const&nbsp;TQSqlCursor&nbsp;&amp;&nbsp;other )</li>
<li class=fn><a href="#~TQSqlCursor"><b>~TQSqlCursor</b></a> ()</li>
<li class=fn>enum <a href="#Mode-enum"><b>Mode</b></a> { ReadOnly = 0, Insert = 1, Update = 2, Delete = 4, Writable = 7 }</li>
-<li class=fn>virtual TQSqlIndex <a href="#primaryIndex"><b>primaryIndex</b></a> ( bool&nbsp;setFromCursor = TRUE ) const</li>
+<li class=fn>virtual TQSqlIndex <a href="#primaryIndex"><b>primaryIndex</b></a> ( bool&nbsp;setFromCursor = true ) const</li>
<li class=fn>virtual TQSqlIndex <a href="#index"><b>index</b></a> ( const&nbsp;TQStringList&nbsp;&amp;&nbsp;fieldNames ) const</li>
<li class=fn>TQSqlIndex <a href="#index-2"><b>index</b></a> ( const&nbsp;TQString&nbsp;&amp;&nbsp;fieldName ) const</li>
<li class=fn>TQSqlIndex <a href="#index-3"><b>index</b></a> ( const&nbsp;char&nbsp;*&nbsp;fieldName ) const</li>
@@ -55,13 +55,13 @@ tables and views.
<li class=fn>virtual void <a href="#clear"><b>clear</b></a> ()</li>
<li class=fn>virtual void <a href="#setGenerated"><b>setGenerated</b></a> ( const&nbsp;TQString&nbsp;&amp;&nbsp;name, bool&nbsp;generated )</li>
<li class=fn>virtual void <a href="#setGenerated-2"><b>setGenerated</b></a> ( int&nbsp;i, bool&nbsp;generated )</li>
-<li class=fn>virtual TQSqlRecord * <a href="#editBuffer"><b>editBuffer</b></a> ( bool&nbsp;copy = FALSE )</li>
+<li class=fn>virtual TQSqlRecord * <a href="#editBuffer"><b>editBuffer</b></a> ( bool&nbsp;copy = false )</li>
<li class=fn>virtual TQSqlRecord * <a href="#primeInsert"><b>primeInsert</b></a> ()</li>
<li class=fn>virtual TQSqlRecord * <a href="#primeUpdate"><b>primeUpdate</b></a> ()</li>
<li class=fn>virtual TQSqlRecord * <a href="#primeDelete"><b>primeDelete</b></a> ()</li>
-<li class=fn>virtual int <a href="#insert-2"><b>insert</b></a> ( bool&nbsp;invalidate = TRUE )</li>
-<li class=fn>virtual int <a href="#update"><b>update</b></a> ( bool&nbsp;invalidate = TRUE )</li>
-<li class=fn>virtual int <a href="#del"><b>del</b></a> ( bool&nbsp;invalidate = TRUE )</li>
+<li class=fn>virtual int <a href="#insert-2"><b>insert</b></a> ( bool&nbsp;invalidate = true )</li>
+<li class=fn>virtual int <a href="#update"><b>update</b></a> ( bool&nbsp;invalidate = true )</li>
+<li class=fn>virtual int <a href="#del"><b>del</b></a> ( bool&nbsp;invalidate = true )</li>
<li class=fn>virtual void <a href="#setMode"><b>setMode</b></a> ( int&nbsp;mode )</li>
<li class=fn>int <a href="#mode"><b>mode</b></a> () const</li>
<li class=fn>virtual void <a href="#setCalculated"><b>setCalculated</b></a> ( const&nbsp;TQString&nbsp;&amp;&nbsp;name, bool&nbsp;calculated )</li>
@@ -80,7 +80,7 @@ tables and views.
<li class=fn>TQSqlIndex <a href="#sort"><b>sort</b></a> () const</li>
<li class=fn>virtual void <a href="#setFilter"><b>setFilter</b></a> ( const&nbsp;TQString&nbsp;&amp;&nbsp;filter )</li>
<li class=fn>TQString <a href="#filter"><b>filter</b></a> () const</li>
-<li class=fn>virtual void <a href="#setName"><b>setName</b></a> ( const&nbsp;TQString&nbsp;&amp;&nbsp;name, bool&nbsp;autopopulate = TRUE )</li>
+<li class=fn>virtual void <a href="#setName"><b>setName</b></a> ( const&nbsp;TQString&nbsp;&amp;&nbsp;name, bool&nbsp;autopopulate = true )</li>
<li class=fn>TQString <a href="#name"><b>name</b></a> () const</li>
<li class=fn>bool <a href="#isNull"><b>isNull</b></a> ( int&nbsp;i ) const</li>
<li class=fn>bool <a href="#isNull-2"><b>isNull</b></a> ( const&nbsp;TQString&nbsp;&amp;&nbsp;name ) const</li>
@@ -88,8 +88,8 @@ tables and views.
<h2>Protected Members</h2>
<ul>
<li class=fn>virtual TQVariant <a href="#calculateField"><b>calculateField</b></a> ( const&nbsp;TQString&nbsp;&amp;&nbsp;name )</li>
-<li class=fn>virtual int <a href="#update-2"><b>update</b></a> ( const&nbsp;TQString&nbsp;&amp;&nbsp;filter, bool&nbsp;invalidate = TRUE )</li>
-<li class=fn>virtual int <a href="#del-2"><b>del</b></a> ( const&nbsp;TQString&nbsp;&amp;&nbsp;filter, bool&nbsp;invalidate = TRUE )</li>
+<li class=fn>virtual int <a href="#update-2"><b>update</b></a> ( const&nbsp;TQString&nbsp;&amp;&nbsp;filter, bool&nbsp;invalidate = true )</li>
+<li class=fn>virtual int <a href="#del-2"><b>del</b></a> ( const&nbsp;TQString&nbsp;&amp;&nbsp;filter, bool&nbsp;invalidate = true )</li>
<li class=fn>virtual TQString <a href="#toString-3"><b>toString</b></a> ( const&nbsp;TQString&nbsp;&amp;&nbsp;prefix, TQSqlField&nbsp;*&nbsp;field, const&nbsp;TQString&nbsp;&amp;&nbsp;fieldSep ) const</li>
<li class=fn>virtual TQString <a href="#toString"><b>toString</b></a> ( TQSqlRecord&nbsp;*&nbsp;rec, const&nbsp;TQString&nbsp;&amp;&nbsp;prefix, const&nbsp;TQString&nbsp;&amp;&nbsp;fieldSep, const&nbsp;TQString&nbsp;&amp;&nbsp;sep ) const</li>
<li class=fn>virtual TQString <a href="#toString-4"><b>toString</b></a> ( const&nbsp;TQSqlIndex&nbsp;&amp;&nbsp;i, TQSqlRecord&nbsp;*&nbsp;rec, const&nbsp;TQString&nbsp;&amp;&nbsp;prefix, const&nbsp;TQString&nbsp;&amp;&nbsp;fieldSep, const&nbsp;TQString&nbsp;&amp;&nbsp;sep ) const</li>
@@ -112,13 +112,13 @@ buffer is separate, and is used for editing existing records and
inserting new records.
<p> For browsing data, a cursor must first <a href="#select">select</a>() data from the
database. After a successful select() the cursor is active
-(<a href="tqsqlquery.html#isActive">isActive</a>() returns TRUE), but is initially not positioned on a
-valid record (<a href="tqsqlquery.html#isValid">isValid</a>() returns FALSE). To position the cursor on
+(<a href="tqsqlquery.html#isActive">isActive</a>() returns true), but is initially not positioned on a
+valid record (<a href="tqsqlquery.html#isValid">isValid</a>() returns false). To position the cursor on
a valid record, use one of the navigation functions, <a href="tqsqlquery.html#next">next</a>(),
<a href="tqsqlquery.html#prev">prev</a>(), <a href="tqsqlquery.html#first">first</a>(), <a href="tqsqlquery.html#last">last</a>(), or <a href="tqsqlquery.html#seek">seek</a>(). Once positioned on a valid
record, data can be retrieved from the browse buffer using
<a href="tqsqlquery.html#value">value</a>(). If a navigation function is not successful, it returns
-FALSE, the cursor will no longer be positioned on a valid record
+false, the cursor will no longer be positioned on a valid record
and the values returned by value() are undefined.
<p> For example:
<p>
@@ -135,7 +135,7 @@ and the values returned by value() are undefined.
view name in the database. Then, <a href="#select">select</a>() is called, which can be
optionally parameterised to filter and order the records
retrieved. Each record in the cursor is retrieved using <a href="tqsqlquery.html#next">next</a>().
-When next() returns FALSE, there are no more records to process,
+When next() returns false, there are no more records to process,
and the loop terminates.
<p> For editing records (rows of data), a cursor contains a separate
edit buffer which is independent of the fields used when browsing.
@@ -179,10 +179,10 @@ the edit buffer. Use this pointer to populate the edit buffer
with new values and then <a href="#insert">insert</a>() the record into the database.
<p> After calling insert(), update() or del(), the cursor is no longer
positioned on a valid record and can no longer be navigated
-(<a href="tqsqlquery.html#isValid">isValid</a>() return FALSE). The reason for this is that any changes
+(<a href="tqsqlquery.html#isValid">isValid</a>() return false). The reason for this is that any changes
made to the database will not be visible until <a href="#select">select</a>() is called
to refresh the cursor. You can change this behavior by passing
-FALSE to insert(), <a href="#update">update</a>() or del() which will prevent the cursor
+false to insert(), <a href="#update">update</a>() or del() which will prevent the cursor
from becoming invalid. The edits will still not be visible when
navigating the cursor until select() is called.
<p> TQSqlCursor contains virtual methods which allow editing behavior
@@ -219,10 +219,10 @@ database.
in the database.
</ul>
<hr><h2>Member Function Documentation</h2>
-<h3 class=fn><a name="TQSqlCursor"></a>TQSqlCursor::TQSqlCursor ( const&nbsp;<a href="tqstring.html">TQString</a>&nbsp;&amp;&nbsp;name = TQString::null, bool&nbsp;autopopulate = TRUE, <a href="tqsqldatabase.html">TQSqlDatabase</a>&nbsp;*&nbsp;db = 0 )
+<h3 class=fn><a name="TQSqlCursor"></a>TQSqlCursor::TQSqlCursor ( const&nbsp;<a href="tqstring.html">TQString</a>&nbsp;&amp;&nbsp;name = TQString::null, bool&nbsp;autopopulate = true, <a href="tqsqldatabase.html">TQSqlDatabase</a>&nbsp;*&nbsp;db = 0 )
</h3>
Constructs a cursor on database <em>db</em> using table or view <em>name</em>.
-<p> If <em>autopopulate</em> is TRUE (the default), the <em>name</em> of the
+<p> If <em>autopopulate</em> is true (the default), the <em>name</em> of the
cursor must correspond to an existing table or view name in the
database so that field information can be automatically created.
If the table or view does not exist, the cursor will not be
@@ -262,20 +262,20 @@ invalid <a href="tqvariant.html">TQVariant</a>.
<p>Examples: <a href="sql.html#x2259">sql/overview/subclass3/main.cpp</a> and <a href="sql.html#x2263">sql/overview/subclass4/main.cpp</a>.
<h3 class=fn>bool <a name="canDelete"></a>TQSqlCursor::canDelete () const
</h3>
-Returns TRUE if the cursor will perform deletes; otherwise returns
-FALSE.
+Returns true if the cursor will perform deletes; otherwise returns
+false.
<p> <p>See also <a href="#setMode">setMode</a>().
<h3 class=fn>bool <a name="canInsert"></a>TQSqlCursor::canInsert () const
</h3>
-Returns TRUE if the cursor will perform inserts; otherwise returns
-FALSE.
+Returns true if the cursor will perform inserts; otherwise returns
+false.
<p> <p>See also <a href="#setMode">setMode</a>().
<h3 class=fn>bool <a name="canUpdate"></a>TQSqlCursor::canUpdate () const
</h3>
-Returns TRUE if the cursor will perform updates; otherwise returns
-FALSE.
+Returns true if the cursor will perform updates; otherwise returns
+false.
<p> <p>See also <a href="#setMode">setMode</a>().
<h3 class=fn>void <a name="clear"></a>TQSqlCursor::clear ()<tt> [virtual]</tt>
@@ -284,7 +284,7 @@ Removes all fields from the cursor. Note that all references to
the cursor edit buffer become invalidated.
<p>Reimplemented from <a href="tqsqlrecord.html#clear">TQSqlRecord</a>.
-<h3 class=fn>int <a name="del"></a>TQSqlCursor::del ( bool&nbsp;invalidate = TRUE )<tt> [virtual]</tt>
+<h3 class=fn>int <a name="del"></a>TQSqlCursor::del ( bool&nbsp;invalidate = true )<tt> [virtual]</tt>
</h3>
Deletes a record from the database using the cursor's primary
index and the contents of the cursor edit buffer. Returns the
@@ -292,7 +292,7 @@ number of records which were deleted.
For error information, use <a href="tqsqlquery.html#lastError">lastError</a>().
<p> Only records which meet the filter criteria specified by the
cursor's primary index are deleted. If the cursor does not contain
-a primary index, no delete is performed and 0 is returned. If <em>invalidate</em> is TRUE (the default), the current cursor can no longer
+a primary index, no delete is performed and 0 is returned. If <em>invalidate</em> is true (the default), the current cursor can no longer
be navigated. A new <a href="#select">select</a>() call must be made before you can move
to a valid record. For example:
<p>
@@ -314,21 +314,21 @@ cursor edit buffer and not on the contents of the cursor itself.
<p> <p>See also <a href="#primeDelete">primeDelete</a>(), <a href="#setMode">setMode</a>(), and <a href="tqsqlquery.html#lastError">lastError</a>().
<p>Example: <a href="sql.html#x2205">sql/overview/delete/main.cpp</a>.
-<h3 class=fn>int <a name="del-2"></a>TQSqlCursor::del ( const&nbsp;<a href="tqstring.html">TQString</a>&nbsp;&amp;&nbsp;filter, bool&nbsp;invalidate = TRUE )<tt> [virtual protected]</tt>
+<h3 class=fn>int <a name="del-2"></a>TQSqlCursor::del ( const&nbsp;<a href="tqstring.html">TQString</a>&nbsp;&amp;&nbsp;filter, bool&nbsp;invalidate = true )<tt> [virtual protected]</tt>
</h3>
This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
<p> Deletes the current cursor record from the database using the
filter <em>filter</em>. Only records which meet the filter criteria are
-deleted. Returns the number of records which were deleted. If <em>invalidate</em> is TRUE (the default), the current cursor can no longer
+deleted. Returns the number of records which were deleted. If <em>invalidate</em> is true (the default), the current cursor can no longer
be navigated. A new <a href="#select">select</a>() call must be made before you can move
to a valid record. For error information, use <a href="tqsqlquery.html#lastError">lastError</a>().
<p> The <em>filter</em> is an SQL <tt>WHERE</tt> clause, e.g. <tt>id=500</tt>.
<p> <p>See also <a href="#setMode">setMode</a>() and <a href="tqsqlquery.html#lastError">lastError</a>().
-<h3 class=fn><a href="tqsqlrecord.html">TQSqlRecord</a>&nbsp;* <a name="editBuffer"></a>TQSqlCursor::editBuffer ( bool&nbsp;copy = FALSE )<tt> [virtual]</tt>
+<h3 class=fn><a href="tqsqlrecord.html">TQSqlRecord</a>&nbsp;* <a name="editBuffer"></a>TQSqlCursor::editBuffer ( bool&nbsp;copy = false )<tt> [virtual]</tt>
</h3>
-Returns the current internal edit buffer. If <em>copy</em> is TRUE (the
-default is FALSE), the current cursor field values are first
+Returns the current internal edit buffer. If <em>copy</em> is true (the
+default is false), the current cursor field values are first
copied into the edit buffer. The edit buffer is valid as long as
the cursor remains valid. The cursor retains ownership of the
returned pointer, so it must not be deleted or modified.
@@ -364,14 +364,14 @@ already exists at <em>pos</em>, it is removed. Note that all references
to the cursor edit buffer become invalidated.
<p>Examples: <a href="sql.html#x2194">sql/overview/insert/main.cpp</a> and <a href="tqsqlcursor.html#x2446">sql/overview/insert2/main.cpp</a>.
-<h3 class=fn>int <a name="insert-2"></a>TQSqlCursor::insert ( bool&nbsp;invalidate = TRUE )<tt> [virtual]</tt>
+<h3 class=fn>int <a name="insert-2"></a>TQSqlCursor::insert ( bool&nbsp;invalidate = true )<tt> [virtual]</tt>
</h3>
This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
<p> Inserts the current contents of the cursor's edit record buffer
into the database, if the cursor allows inserts. Returns the
number of rows affected by the insert. For error information, use
<a href="tqsqlquery.html#lastError">lastError</a>().
-<p> If <em>invalidate</em> is TRUE (the default), the cursor will no longer
+<p> If <em>invalidate</em> is true (the default), the cursor will no longer
be positioned on a valid record and can no longer be navigated. A
new <a href="#select">select</a>() call must be made before navigating to a valid
record.
@@ -395,34 +395,34 @@ cursor itself.
<h3 class=fn>bool <a name="isCalculated"></a>TQSqlCursor::isCalculated ( const&nbsp;<a href="tqstring.html">TQString</a>&nbsp;&amp;&nbsp;name ) const
</h3>
-Returns TRUE if the field <em>name</em> exists and is calculated;
-otherwise returns FALSE.
+Returns true if the field <em>name</em> exists and is calculated;
+otherwise returns false.
<p> <p>See also <a href="#setCalculated">setCalculated</a>().
<h3 class=fn>bool <a name="isNull"></a>TQSqlCursor::isNull ( int&nbsp;i ) const
</h3>
-Returns TRUE if the field <em>i</em> is NULL or if there is no field at
-position <em>i</em>; otherwise returns FALSE.
+Returns true if the field <em>i</em> is NULL or if there is no field at
+position <em>i</em>; otherwise returns false.
<p> This is the same as calling <a href="tqsqlrecord.html#isNull">TQSqlRecord::isNull</a>( <em>i</em> )
<h3 class=fn>bool <a name="isNull-2"></a>TQSqlCursor::isNull ( const&nbsp;<a href="tqstring.html">TQString</a>&nbsp;&amp;&nbsp;name ) const
</h3>
This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
-<p> Returns TRUE if the field called <em>name</em> is NULL or if there is no
-field called <em>name</em>; otherwise returns FALSE.
+<p> Returns true if the field called <em>name</em> is NULL or if there is no
+field called <em>name</em>; otherwise returns false.
<p> This is the same as calling <a href="tqsqlrecord.html#isNull">TQSqlRecord::isNull</a>( <em>name</em> )
<h3 class=fn>bool <a name="isReadOnly"></a>TQSqlCursor::isReadOnly () const
</h3>
-Returns TRUE if the cursor is read-only; otherwise returns FALSE.
-The default is FALSE. Read-only cursors cannot be edited using
+Returns true if the cursor is read-only; otherwise returns false.
+The default is false. Read-only cursors cannot be edited using
<a href="#insert">insert</a>(), <a href="#update">update</a>() or <a href="#del">del</a>().
<p> <p>See also <a href="#setMode">setMode</a>().
<h3 class=fn>bool <a name="isTrimmed"></a>TQSqlCursor::isTrimmed ( const&nbsp;<a href="tqstring.html">TQString</a>&nbsp;&amp;&nbsp;name ) const
</h3>
-Returns TRUE if the field <em>name</em> exists and is trimmed; otherwise
-returns FALSE.
+Returns true if the field <em>name</em> exists and is trimmed; otherwise
+returns false.
<p> When a trimmed field of type string or cstring is read from the
database any trailing (right-most) spaces are removed.
<p> <p>See also <a href="#setTrimmed">setTrimmed</a>().
@@ -440,11 +440,11 @@ Returns the name of the cursor.
</h3>
Sets the cursor equal to <em>other</em>.
-<h3 class=fn><a href="tqsqlindex.html">TQSqlIndex</a> <a name="primaryIndex"></a>TQSqlCursor::primaryIndex ( bool&nbsp;setFromCursor = TRUE ) const<tt> [virtual]</tt>
+<h3 class=fn><a href="tqsqlindex.html">TQSqlIndex</a> <a name="primaryIndex"></a>TQSqlCursor::primaryIndex ( bool&nbsp;setFromCursor = true ) const<tt> [virtual]</tt>
</h3>
Returns the primary index associated with the cursor as defined in
the database, or an empty index if there is no primary index. If
-<em>setFromCursor</em> is TRUE (the default), the index fields are
+<em>setFromCursor</em> is true (the default), the index fields are
populated with the corresponding values in the cursor's current
record.
@@ -454,7 +454,7 @@ This function primes the edit buffer's field values for delete and
returns the edit buffer. The default implementation copies the
field values from the current cursor record into the edit buffer
(therefore, this function is equivalent to calling <a href="#editBuffer">editBuffer</a>(
-TRUE ) ). The cursor retains ownership of the returned pointer, so
+true ) ). The cursor retains ownership of the returned pointer, so
it must not be deleted or modified.
<p> <p>See also <a href="#editBuffer">editBuffer</a>() and <a href="#del">del</a>().
@@ -474,7 +474,7 @@ This function primes the edit buffer's field values for update and
returns the edit buffer. The default implementation copies the
field values from the current cursor record into the edit buffer
(therefore, this function is equivalent to calling <a href="#editBuffer">editBuffer</a>(
-TRUE ) ). The cursor retains ownership of the returned pointer, so
+true ) ). The cursor retains ownership of the returned pointer, so
it must not be deleted or modified.
<p> <p>See also <a href="#editBuffer">editBuffer</a>() and <a href="#update">update</a>().
@@ -490,8 +490,8 @@ invalidated.
</h3>
Selects all fields in the cursor from the database matching the
filter criteria <em>filter</em>. The data is returned in the order
-specified by the index <em>sort</em>. Returns TRUE if the data was
-successfully selected; otherwise returns FALSE.
+specified by the index <em>sort</em>. Returns true if the data was
+successfully selected; otherwise returns false.
<p> The <em>filter</em> is a string containing a SQL <tt>WHERE</tt> clause but
without the 'WHERE' keyword. The cursor is initially positioned at
an invalid row after this function is called. To move to a valid
@@ -601,7 +601,7 @@ e.g. <tt>name='Dave'</tt> which will be processed by the DBMS.
</h3>
Sets the generated flag for the field <em>name</em> to <em>generated</em>. If
the field does not exist, nothing happens. Only fields that have
-<em>generated</em> set to TRUE are included in the SQL that is
+<em>generated</em> set to true are included in the SQL that is
generated by <a href="#insert">insert</a>(), <a href="#update">update</a>() or <a href="#del">del</a>().
<p> <p>See also <a href="tqsqlrecord.html#isGenerated">isGenerated</a>().
@@ -629,9 +629,9 @@ cursor is <a href="#Mode-enum">TQSqlCursor::Writable</a>.
</pre>
-<h3 class=fn>void <a name="setName"></a>TQSqlCursor::setName ( const&nbsp;<a href="tqstring.html">TQString</a>&nbsp;&amp;&nbsp;name, bool&nbsp;autopopulate = TRUE )<tt> [virtual]</tt>
+<h3 class=fn>void <a name="setName"></a>TQSqlCursor::setName ( const&nbsp;<a href="tqstring.html">TQString</a>&nbsp;&amp;&nbsp;name, bool&nbsp;autopopulate = true )<tt> [virtual]</tt>
</h3>
-Sets the name of the cursor to <em>name</em>. If <em>autopopulate</em> is TRUE
+Sets the name of the cursor to <em>name</em>. If <em>autopopulate</em> is true
(the default), the <em>name</em> must correspond to a valid table or
view name in the database. Also, note that all references to the
cursor edit buffer become invalidated when fields are
@@ -671,7 +671,7 @@ Each field is composed of the <em>prefix</em> (e.g. table or view name),
".", the field name, the <em>fieldSep</em> and the field value. If the
<em>prefix</em> is empty then each field will begin with the field name.
The fields are then joined together separated by <em>sep</em>. Fields
-where <a href="tqsqlrecord.html#isGenerated">isGenerated</a>() returns FALSE are not included. This function
+where <a href="tqsqlrecord.html#isGenerated">isGenerated</a>() returns false are not included. This function
is useful for generating SQL statements.
<h3 class=fn><a href="tqstring.html">TQString</a> <a name="toString-3"></a>TQSqlCursor::toString ( const&nbsp;<a href="tqstring.html">TQString</a>&nbsp;&amp;&nbsp;prefix, <a href="tqsqlfield.html">TQSqlField</a>&nbsp;*&nbsp;field, const&nbsp;<a href="tqstring.html">TQString</a>&nbsp;&amp;&nbsp;fieldSep ) const<tt> [virtual protected]</tt>
@@ -692,10 +692,10 @@ name), ".", the field name, the <em>fieldSep</em> and the field value.
If the <em>prefix</em> is empty then each field will begin with the field
name. The field values are taken from <em>rec</em>. The fields are then
joined together separated by <em>sep</em>. Fields where <a href="tqsqlrecord.html#isGenerated">isGenerated</a>()
-returns FALSE are ignored. This function is useful for generating
+returns false are ignored. This function is useful for generating
SQL statements.
-<h3 class=fn>int <a name="update"></a>TQSqlCursor::update ( bool&nbsp;invalidate = TRUE )<tt> [virtual]</tt>
+<h3 class=fn>int <a name="update"></a>TQSqlCursor::update ( bool&nbsp;invalidate = true )<tt> [virtual]</tt>
</h3>
Updates the database with the current contents of the edit buffer.
Returns the number of records which were updated.
@@ -703,7 +703,7 @@ For error information, use <a href="tqsqlquery.html#lastError">lastError</a>().
<p> Only records which meet the filter criteria specified by the
cursor's primary index are updated. If the cursor does not contain
a primary index, no update is performed and 0 is returned.
-<p> If <em>invalidate</em> is TRUE (the default), the current cursor can no
+<p> If <em>invalidate</em> is true (the default), the current cursor can no
longer be navigated. A new <a href="#select">select</a>() call must be made before you
can move to a valid record. For example:
<p>
@@ -733,7 +733,7 @@ records the database may be changed into an inconsistent state.
<p> <p>See also <a href="#setMode">setMode</a>() and <a href="tqsqlquery.html#lastError">lastError</a>().
<p>Example: <a href="sql.html#x2201">sql/overview/update/main.cpp</a>.
-<h3 class=fn>int <a name="update-2"></a>TQSqlCursor::update ( const&nbsp;<a href="tqstring.html">TQString</a>&nbsp;&amp;&nbsp;filter, bool&nbsp;invalidate = TRUE )<tt> [virtual protected]</tt>
+<h3 class=fn>int <a name="update-2"></a>TQSqlCursor::update ( const&nbsp;<a href="tqstring.html">TQString</a>&nbsp;&amp;&nbsp;filter, bool&nbsp;invalidate = true )<tt> [virtual protected]</tt>
</h3>
This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
<p> Updates the database with the current contents of the cursor edit
@@ -742,7 +742,7 @@ records which were updated.
For error information, use <a href="tqsqlquery.html#lastError">lastError</a>().
<p> Only records which meet the filter criteria are updated, otherwise
all records in the table are updated.
-<p> If <em>invalidate</em> is TRUE (the default), the cursor can no longer
+<p> If <em>invalidate</em> is true (the default), the cursor can no longer
be navigated. A new <a href="#select">select</a>() call must be made before you can move
to a valid record.
<p> <p>See also <a href="#primeUpdate">primeUpdate</a>(), <a href="#setMode">setMode</a>(), and <a href="tqsqlquery.html#lastError">lastError</a>().