home *** CD-ROM | disk | FTP | other *** search
/ NeXTSTEP 3.3 (Developer) / NeXT_Developer-3.3.iso / usr / sybase / doc / dbgetchar.man < prev    next >
Encoding:
Text File  |  1993-04-22  |  2.0 KB  |  67 lines
  1.  
  2.   1                       Version 4.0 -- 5/1/89                dbgetchar
  3.   ______________________________________________________________________
  4.  
  5.   NAME:  dbgetchar
  6.  
  7.   FUNCTION:
  8.        Return a pointer to a character in the command buffer.
  9.  
  10.   SYNTAX:
  11.        char *dbgetchar(dbproc, n)
  12.  
  13.        DBPROCESS *dbproc;
  14.        int       n;
  15.  
  16.   COMMENTS:
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.   dbgetchar               Version 4.0 -- 5/1/89                        2
  25.   ______________________________________________________________________
  26.  
  27.        o You can use dbgetchar() to find a particular character  in  the
  28.          command  buffer.  It returns a pointer to the n'th character in
  29.          the command buffer.
  30.        o Internally, the command buffer is a linked  list  of  non-null-
  31.          terminated   text   strings.    dbgetchar(),   dbstrcpy(),  and
  32.          dbstrlen() together provide a way to locate and copy  parts  of
  33.          the command buffer.
  34.  
  35.        o Since the command buffer is not just one large text string, but
  36.          rather  a linked list of text strings, you must use dbgetchar()
  37.          to index through the buffer.  If you just get a  pointer  using
  38.          dbgetchar()  and  then  increment it yourself, it will probably
  39.          fall off the end of a string and cause a segmentation fault.
  40.  
  41.   PARAMETERS:
  42.        dbproc -  A pointer to the DBPROCESS structure that provides  the
  43.            connection for a particular front-end/SQL Server process.  It
  44.  
  45.  
  46.   3                       Version 4.0 -- 5/1/89                dbgetchar
  47.   ______________________________________________________________________
  48.            contains all the information that DB-Library uses  to  manage
  49.            communications and data between the front end and SQL Server.
  50.        n -  The character to find in  the  command  buffer.   The  first
  51.            character is the 0'th character.
  52.  
  53.   RETURNS:
  54.        dbgetchar() returns a pointer to the n'th character in  the  com-
  55.        mand buffer.  If n is not in range, dbgetchar() returns NULL.
  56.  
  57.   SEE ALSO:
  58.        dbcmd, dbfcmd, dbfreebuf, dbstrcpy, dbstrlen
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.