home *** CD-ROM | disk | FTP | other *** search
/ NeXTSTEP 3.3 (Developer) / NeXT_Developer-3.3.iso / usr / sybase / doc / dbfreebuf.man < prev    next >
Encoding:
Text File  |  1993-04-22  |  1.8 KB  |  67 lines
  1.  
  2.   1                       Version 4.0 -- 5/1/89                dbfreebuf
  3.   ______________________________________________________________________
  4.  
  5.   NAME:  dbfreebuf
  6.  
  7.   FUNCTION:
  8.        Clear the command buffer.
  9.  
  10.   SYNTAX:
  11.        void dbfreebuf(dbproc)
  12.  
  13.        DBPROCESS *dbproc;
  14.  
  15.   COMMENTS:
  16.  
  17.        o This routine clears a DBPROCESS command buffer by  freeing  any
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.   dbfreebuf               Version 4.0 -- 5/1/89                        2
  25.   ______________________________________________________________________
  26.          space allocated to it.  It then  sets  the  command  buffer  to
  27.          NULL.   Commands  are  added  to  the  command  buffer with the
  28.          dbcmd() or dbfcmd() routine.
  29.  
  30.        o After a call to dbsqlexec() or dbsqlsend(), the first  call  to
  31.          either  dbcmd()  or dbfcmd() automatically calls dbfreebuf() to
  32.          clear the command buffer before the new text  is  entered.   If
  33.          this  situation  is  undesirable,  set the DBNOAUTOFREE option.
  34.          When DBNOAUTOFREE is set, the command buffer is cleared only by
  35.          an explicit call to dbfreebuf().
  36.        o At any time, the application can access  the  contents  of  the
  37.          command  buffer  through  calls to dbgetchar(), dbstrlen(), and
  38.          dbstrcpy().
  39.  
  40.   PARAMETERS:
  41.        dbproc -  A pointer to the DBPROCESS structure that provides  the
  42.            connection for a particular front-end/SQL Server process.  It
  43.  
  44.  
  45.  
  46.   3                       Version 4.0 -- 5/1/89                dbfreebuf
  47.   ______________________________________________________________________
  48.            contains all the information that DB-Library uses  to  manage
  49.            communications and data between the front end and SQL Server.
  50.  
  51.   RETURNS:
  52.        None.
  53.  
  54.   SEE ALSO:
  55.        dbcmd,  dbfcmd,  dbgetchar,   dbsqlexec,   dbsqlsend,   dbstrcpy,
  56.        dbstrlen, options
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.