home *** CD-ROM | disk | FTP | other *** search
/ NeXTSTEP 3.3 (Developer) / NeXT_Developer-3.3.iso / usr / sybase / doc / dbrows.man < prev    next >
Encoding:
Text File  |  1993-04-22  |  1.8 KB  |  67 lines
  1.  
  2.   1                       Version 4.0 -- 5/1/89                   DBROWS
  3.   ______________________________________________________________________
  4.  
  5.   NAME:  DBROWS
  6.  
  7.   FUNCTION:
  8.        Indicate whether the current command actually returned rows.
  9.  
  10.   SYNTAX:
  11.        RETCODE DBROWS(dbproc)
  12.  
  13.        DBPROCESS *dbproc;
  14.  
  15.   COMMENTS:
  16.  
  17.        o This macro  determines  whether  the  command  currently  being
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.   DBROWS                  Version 4.0 -- 5/1/89                        2
  25.   ______________________________________________________________________
  26.          processed by dbresults() returned any  rows.   The  application
  27.          can call it after dbresults() returns SUCCEED.
  28.  
  29.        o The application must not call DBROWS() after dbnextrow().   The
  30.          macro may return the wrong result at that time.
  31.        o The application can use DBROWS() to determine whether it  needs
  32.          to  call  dbnextrow()  to  process  result  rows.   If DBROWS()
  33.          returns FAIL, the application can skip the dbnextrow() calls.
  34.  
  35.        o The DBCMDROW() macro determines whether the current command  is
  36.          one that can return rows (i.e., a Transact-SQL SELECT statement
  37.          or an EXECUTE on a stored procedure containing a SELECT).
  38.  
  39.   PARAMETERS:
  40.        dbproc -  A pointer to the DBPROCESS structure that provides  the
  41.            connection for a particular front-end/SQL Server process.  It
  42.            contains all the information that DB-Library uses  to  manage
  43.            communications and data between the front end and SQL Server.
  44.  
  45.  
  46.   3                       Version 4.0 -- 5/1/89                   DBROWS
  47.   ______________________________________________________________________
  48.  
  49.   RETURNS:
  50.        SUCCEED or FAIL, indicating whether the current command  returned
  51.        rows.
  52.  
  53.   SEE ALSO:
  54.        DBCMDROW, dbnextrow, dbresults, DBROWTYPE
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.