dbcurrow

DB Library for C

DB Library for C

dbcurrow

Returns the number of the row currently being read.

Syntax

DBINT dbcurrow ( PDBPROCESS dproc );

Arguments

dbproc

Is the DBPROCESS structure that is the handle for a particular workstation or Microsoft® SQL Server™ 2000 process. It contains all the information that DB-Library uses to manage communications and data between the workstation and SQL Server.

Returns

The number of the current row.

Remarks

dbcurrow returns the number of the row most recently read by dbgetrow or dbnextrow. When you do not turn on row buffering, dbfirstrow, dbcurrow, and dblastrow always return the same value (the number of the current row).

Use dbgetrow to read rows from the row buffer.

The first row returned from SQL Server is number 1. The row number is changed every time dbnextrow or dbgetrow returns SUCCEED. The row number is reset to 0 by each new call to dbresults.

See Also

dbclrbuf

DB-Library Options

dbfirstrow

dbnextrow

dbgetrow

dbresults

dblastrow

dbsetopt