home *** CD-ROM | disk | FTP | other *** search
/ NeXTSTEP 3.3 (Developer) / NeXT_Developer-3.3.iso / NextLibrary / Documentation / Sybase / DBLIB / Section2 / dbtsnewlen.nr < prev    next >
Encoding:
Text File  |  1993-04-22  |  1.5 KB  |  51 lines
  1. .Na "dbtsnewlen"
  2. .mc |
  3. .Aa
  4. .Fu
  5. Return the length of the new value of the timestamp column 
  6. after a browse-mode update.
  7. .Ih "timestamp column, length of (browse mode)"
  8. .Sy
  9. .Sf "int dbtsnewlen(dbproc)"
  10. .Sp "DBPROCESS" "*dbproc"
  11. .Co
  12. .Bl
  13. \f2dbtsnewlen()\f1 is one of the \*L browse mode routines.
  14. See the Introduction for a detailed discussion of browse mode.
  15. .Bl
  16. \f2dbtsnewlen()\f1 provides information about the timestamp column.
  17. The WHERE clause returned by \f2dbqual()\f1 contains a call to the
  18. \f2tsequal\f1 built-in function.
  19. .Ih "tsequal function"
  20. When such a WHERE clause is used in an UPDATE statement,
  21. the \f2tsequal\f1 function places a new value in
  22. the updated row's timestamp column and returns the new timestamp value
  23. to the application (if the update is successful).
  24. The \f2dbtsnewlen()\f1 function allows the application to save the length
  25. of the new timestamp value, possibly for use with \f2dbtsput()\f1.
  26. .Bz
  27. .Pa
  28. .Pi dbproc
  29. A pointer to the DBPROCESS structure that provides the connection
  30. for a particular front-end/\*S process.  It contains all the
  31. information that \*L uses to manage communications and data between the
  32. front end and \*S.
  33. .in -.375i
  34. .Re
  35. .br
  36. The length (in bytes) of the updated row's new timestamp value. If no timestamp
  37. was returned to the application (possibly because the update was
  38. unsuccessful, or because the UPDATE statement did not contain
  39. the \f2tsequal\f1 built-in function), \f2dbtsnewlen()\f1 will return -1.
  40. .Sa
  41. dbcolbrowse,
  42. dbcolsource,
  43. dbqual,
  44. dbtabbrowse,
  45. dbtabcount,
  46. dbtabname,
  47. dbtabsource,
  48. dbtsnewval,
  49. dbtsput
  50. .mc
  51.