home *** CD-ROM | disk | FTP | other *** search
/ NeXTSTEP 3.3 (Developer) / NeXT_Developer-3.3.iso / usr / sybase / doc / dbfirstrow.man < prev    next >
Encoding:
Text File  |  1993-04-22  |  1.9 KB  |  67 lines
  1.  
  2.   1                       Version 4.0 -- 5/1/89               DBFIRSTROW
  3.   ______________________________________________________________________
  4.  
  5.   NAME:  DBFIRSTROW
  6.  
  7.   FUNCTION:
  8.        Return the number of the first row in the row buffer.
  9.  
  10.   SYNTAX:
  11.        DBINT DBFIRSTROW(dbproc)
  12.  
  13.        DBPROCESS *dbproc;
  14.  
  15.   COMMENTS:
  16.  
  17.        o This macro returns the number of  the  first  row  in  the  row
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.   DBFIRSTROW              Version 4.0 -- 5/1/89                        2
  25.   ______________________________________________________________________
  26.          buffer.
  27.  
  28.        o If you aren't buffering  rows,  DBFIRSTROW(),  DBCURROW(),  and
  29.          DBLASTROW()  always  have  the same value.  If you have enabled
  30.          buffering by setting the DBBUFFER option, DBFIRSTROW()  returns
  31.          the number of the first row in the row buffer.
  32.        o Note that the first row returned from SQL Server  (whose  value
  33.          is  1) is not necessarily the first row in the row buffer.  The
  34.          rows in the row buffer are dependent  on  manipulation  by  the
  35.          application  program.   See  the  dbclrbuf()  manual  page  for
  36.          details.
  37.  
  38.   PARAMETERS:
  39.        dbproc -  A pointer to the DBPROCESS structure that provides  the
  40.            connection for a particular front-end/SQL Server process.  It
  41.            contains all the information that DB-Library uses  to  manage
  42.            communications and data between the front end and SQL Server.
  43.  
  44.  
  45.  
  46.   3                       Version 4.0 -- 5/1/89               DBFIRSTROW
  47.   ______________________________________________________________________
  48.  
  49.   RETURNS:
  50.        The number of the first row in the row buffer.  Rows are  counted
  51.        from  the  first row returned from SQL Server, whose number is 1.
  52.        This routine returns 0 if there's an error.
  53.  
  54.   SEE ALSO:
  55.        dbclrbuf, DBCURROW,  dbgetrow,  DBLASTROW,  dbnextrow,  dbsetopt,
  56.        options
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.