.\" This man page is automatically generated using
.\" kayadoc2man from the Kaya development tools and the -xmldocs compile 
.\" option. Editing it directly is not encouraged.
.\" It is under the same license as the source .k file that it was
.\" generated from.
.TH "DB.DBIncResult" "3kaya" "August 2014" "Kaya" "Kaya module reference"
.SH "NAME"
DB::DBIncResult \- An incremental query result
.SH "SYNOPSIS"
.B DB::DBIncResult<
\fIa\fP
.B >
.IP "" -2
= 
.BI "DBIncRes(" "DB::DBHandle<a>  con,Int rows,Int cols,[String] colnames,Ptr resptr" ")"
.SH "DESCRIPTION"
.PP
DBIncResult holds data about the result of an incremental query, if the database-specific library supports these.
.IP "" -2
- 
\fBrows \fP
is the number of rows in the result set.
.IP "" -2
- 
\fBcols \fP
is the number of columns in each row of the result set.
.IP "" -2
- 
\fBcolnames \fP
is a list of the names of the columns
.IP "" -2
- 
\fBresptr \fP
is an internal pointer kept by the relevant database interface.
.PP
An incremental query returns data only one row at a time, which may save memory on large result sets. Depending on the internal implementation in the database-specific library, the
\fBrows \fP
field may not contain useful information. Database-specific libraries should throw an Exception if an attempt is made to read more rows than exist.
.IP "" -4
 res = incExec(conn,"SELECT id,name FROM People");
 row = getRow(res);
 // row[0] = DBInt(id)
 // row[1] = DBText(name)
.SH "AUTHORS"
Kaya standard library by Edwin Brady, Chris Morris and others (kaya@kayalang.org). For further information see http://kayalang.org/
.SH LICENSE
The Kaya standard library is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License (version 2.1 or any later version) as published by the Free Software Foundation.
.SH "RELATED"
.PD 0
.PP
.B "DB.DBResult"(3kaya)
.PP
.B "DB.DBValue"(3kaya)
.PP
.B "DB.getRow"(3kaya)
.PP
.B "DB.incDiscard"(3kaya)
.PP
.B "DB.incExec"(3kaya)
.PD 0.4v