home *** CD-ROM | disk | FTP | other *** search
/ NeXTSTEP 3.3 (Developer) / NeXT_Developer-3.3.iso / NextLibrary / Documentation / Sybase / DBLIB / Section2 / dbtxtimestamp.nr < prev    next >
Encoding:
Text File  |  1993-04-22  |  1.4 KB  |  46 lines
  1. .Na "dbtxtimestamp" 
  2. .mc |
  3. .Aa
  4. .Fu
  5. Return the value of the text timestamp for a column
  6. in the current row.
  7. .Ih "timestamp, text, returning value of"
  8. .Ih "text timestamp, returning value of"
  9. .Sy
  10. .Sf "DBBINARY *dbtxtimestamp(dbproc, column)"
  11. .Sp "DBPROCESS" "*dbproc"
  12. .Sp "int" "column"
  13. .Co
  14. .Bl
  15. Every database column of type SYBTEXT or SYBIMAGE has an associated
  16. text timestamp, which marks the time of the column's last modification.
  17. The text timestamp is useful in conjunction with the \f2dbwritetext()\f1
  18. function, to ensure that two competing application users do not inadvertently
  19. wipe out each other's modifications to the same value in the database.
  20. It is returned to the DBPROCESS when a \*N SELECT is performed
  21. on a SYBTEXT or SYBIMAGE column.
  22. .Bl
  23. The length of a non-NULL text timestamp is always DBTXTSLEN (currently
  24. defined as eight bytes).
  25. .Bl
  26. For an example that uses \f2dbtxtimestamp()\f1, see the \f2dbwritetext()\f1 manual page.
  27. .Bz
  28. .Pa
  29. .Pi dbproc
  30. A pointer to the DBPROCESS structure that provides the connection
  31. for a particular front-end/\*S process.  It contains all the
  32. information that \*L uses to manage communications and data between the
  33. front end and \*S.
  34. .Pi column
  35. The number of the column of interest.
  36. The first column in a table is number 1.
  37. .in -.375i
  38. .Re
  39. .br
  40. A DBBINARY pointer to the text timestamp for the column of interest.
  41. This pointer may be NULL.
  42. .Sa
  43. dbtxptr, 
  44. dbwritetext
  45. .mc
  46.