home *** CD-ROM | disk | FTP | other *** search
/ NeXTSTEP 3.3 (Developer) / NeXT_Developer-3.3.iso / NextLibrary / Documentation / Sybase / DBLIB / Section2 / dbfreebuf.nr < prev    next >
Encoding:
Text File  |  1993-04-22  |  1.2 KB  |  55 lines
  1. .Na "dbfreebuf" 
  2. .Aa
  3. .Fu
  4. Clear the command buffer.
  5. .Ih "command buffer, clearing"
  6. .Sy
  7. .Sf "void dbfreebuf(dbproc)"
  8. .Sp "DBPROCESS" "*dbproc"
  9. .Co
  10. .Bl
  11. This routine clears a DBPROCESS command buffer by freeing 
  12. any space allocated to it.
  13. It then sets the
  14. command buffer to NULL.
  15. Commands are added to the command buffer with the
  16. .I "dbcmd()"
  17. or
  18. .I "dbfcmd()"
  19. routine.
  20. .Bl
  21. After a call to \f2dbsqlexec()\f1 or \f2dbsqlsend()\f1,
  22. the first call to either \f2dbcmd()\f1 or \f2dbfcmd()\f1 
  23. automatically calls \f2dbfreebuf()\f1 to clear the command buffer before the new text is entered.
  24. If this situation is undesirable, set the DBNOAUTOFREE option.
  25. .Ih "DBNOAUTOFREE option"
  26. When DBNOAUTOFREE is set, the command buffer is cleared only by an
  27. explicit call to \f2dbfreebuf()\f1.
  28. .Bl
  29. At any time,
  30. the application can access the
  31. contents of the command buffer through calls to
  32. .I "dbgetchar(), dbstrlen(),"
  33. and
  34. .I "dbstrcpy()."
  35. .Bz
  36. .Pa
  37. .Pi dbproc
  38. A pointer to the DBPROCESS structure that provides the connection
  39. for a particular front-end/\*S process.  It contains all the
  40. information that \*L uses to manage communications and data between the
  41. front end and \*S.
  42. .in -.375i
  43. .Re
  44. .br
  45. None.
  46. .Sa
  47. dbcmd,
  48. dbfcmd,
  49. dbgetchar,
  50. dbsqlexec,
  51. dbsqlsend,
  52. dbstrcpy,
  53. dbstrlen,
  54. options
  55.