home *** CD-ROM | disk | FTP | other *** search
/ NeXTSTEP 3.3 (Developer) / NeXT_Developer-3.3.iso / NextLibrary / Documentation / Sybase / DBLIB / Section2 / dbrows.nr < prev    next >
Encoding:
Text File  |  1993-04-22  |  1.3 KB  |  46 lines
  1. .Na "DBROWS" 
  2. .Aa
  3. .Fu
  4. Indicate whether the current command actually returned rows.
  5. .Ih "command, determining whether it returned rows"
  6. .Sy
  7. .Sf "RETCODE DBROWS(dbproc)"
  8. .Sp "DBPROCESS" "*dbproc"
  9. .Co
  10. .Bl
  11. This macro determines whether the command currently being
  12. processed by \f2dbresults()\f1 returned any rows.
  13. The application can call it after
  14. .I "dbresults()"
  15. returns SUCCEED.
  16. .Bl
  17. The application must not call \f2DBROWS()\f1 after \f2dbnextrow()\f1.
  18. The macro may return the wrong result at that time.
  19. .Bl
  20. The application can use \f2DBROWS()\f1 to determine whether it
  21. needs to call \f2dbnextrow()\f1 to process result rows.
  22. If \f2DBROWS()\f1 returns FAIL, the application can skip the \f2dbnextrow()\f1 calls.
  23. .Bl
  24. The
  25. .I "DBCMDROW()"
  26. macro determines whether the current command is one that \f2can\f1 return rows
  27. (\f2i.e.,\f1 a \*N SELECT statement or an EXECUTE on a stored procedure
  28. containing a SELECT).
  29. .Bz
  30. .Pa
  31. .Pi dbproc
  32. A pointer to the DBPROCESS structure that provides the connection
  33. for a particular front-end/\*S process.  It contains all the
  34. information that \*L uses to manage communications and data between the
  35. front end and \*S.
  36. .in -.375i
  37. .Re
  38. .br
  39. SUCCEED or FAIL, indicating whether the current
  40. command returned rows.
  41. .Sa
  42. DBCMDROW,
  43. dbnextrow,
  44. dbresults,
  45. DBROWTYPE
  46.