home *** CD-ROM | disk | FTP | other *** search
/ NeXTSTEP 3.3 (Developer) / NeXT_Developer-3.3.iso / usr / sybase / doc / dbvarylen.man < prev    next >
Encoding:
Text File  |  1993-04-22  |  2.0 KB  |  67 lines
  1.  
  2.   1                       Version 4.0 -- 5/1/89                dbvarylen
  3.   ______________________________________________________________________
  4.  
  5.   NAME:  dbvarylen
  6.  
  7.   FUNCTION:
  8.        Determine whether the specified regular result column's data  can
  9.        vary in length.
  10.  
  11.   SYNTAX:
  12.        DBBOOL dbvarylen(dbproc, column)
  13.  
  14.        DBPROCESS *dbproc;
  15.        int       column;
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.   dbvarylen               Version 4.0 -- 5/1/89                        2
  25.   ______________________________________________________________________
  26.  
  27.   COMMENTS:
  28.  
  29.        o This routine indicates  whether  a  particular  regular  (i.e.,
  30.          non-compute)  result column's data can vary in length.  It will
  31.          return TRUE if the result column is  derived  from  a  database
  32.          column  of  type  varchar,  varbinary, text, or image.  It will
  33.          also return TRUE if the source database column  is  defined  as
  34.          NULL, meaning that it may contain a null value.
  35.        o This routine  is  useful  with  programs  that  handle  ad  hoc
  36.          queries,  if the program needs to be alerted to the possibility
  37.          of null or variable length data.
  38.  
  39.        o You can use dbcoltype() to get a column's datatype.
  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                dbvarylen
  47.   ______________________________________________________________________
  48.            contains all the information that DB-Library uses  to  manage
  49.            communications and data between the front end and SQL Server.
  50.        column -  The number of the regular result  column  of  interest.
  51.            The first column is number 1.
  52.  
  53.   RETURNS:
  54.        TRUE or FALSE, indicating whether or not the  column's  data  can
  55.        vary  in  length.   dbvarylen()  also returns FALSE if the column
  56.        number is out of range.
  57.  
  58.   SEE ALSO:
  59.        dbcollen,  dbcolname,  dbcoltype,  dbdata,  dbdatlen,  dbnumcols,
  60.        dbprtype, types
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.