home *** CD-ROM | disk | FTP | other *** search
/ NeXTSTEP 3.3 (Developer) / NeXT_Developer-3.3.iso / NextLibrary / Documentation / Sybase / DBLIB / Section3 / bcp_colptr.nr < prev    next >
Encoding:
Text File  |  1993-04-22  |  1.4 KB  |  50 lines
  1. .Na "bcp_colptr"
  2. .mc |
  3. .Aa
  4. .Fu
  5. Set the program variable data address for the current copy IN.
  6. .Ih "bcp, set the program variable data address"
  7. .Sy
  8. .Sf "RETCODE bcp_colptr(dbproc, colptr, table_column)"
  9. .Sp "DBPROCESS" "*dbproc"
  10. .Sp "BYTE" "*colptr"
  11. .Sp "int" "table_column"
  12. .Co
  13. .Bl
  14. The \f2bcp_colptr()\f1 function allows you to change the program variable
  15. data address for a particular column while running a copy IN via
  16. calls to \f2bcp_bind().\f1
  17. .Bl
  18. Initially, the program variable data address is determined when
  19. \f2bcp_bind()\f1 is called. If the program variable data address changes
  20. between calls to \f2bcp_sendrow(),\f1 you may call \f2bcp_colptr()\f1 to reset
  21. the address of the data.  The next call to \f2bcp_sendrow()\f1 will use
  22. the data at the address you just set.
  23. .Bl
  24. There must be a separate \f2bcp_colptr()\f1 call for every column in
  25. the table whose data address you want to modify.
  26. .Bl
  27. For information on the \f2bcp\f1 utility program, see its manual page
  28. in the \f2Commands Reference\f1.
  29. .Bz
  30. .Pa
  31. .Pi dbproc
  32. A pointer to the DBPROCESS structure that provides the connection
  33. for a particular front-end/\*S process.  It contains all the
  34. information that \*L uses to manage communications and data between the
  35. front end and \*S.
  36. .Pi colptr 
  37. The address of the program variable.
  38. .Pi table_column 
  39. The column in the \*S table to which the data will
  40. be copied. Column numbers start at 1.
  41. .in -.375i
  42. .Re
  43. .br
  44. SUCCEED or FAIL.
  45. .Sa
  46. bcp_bind, 
  47. bcp_collen, 
  48. bcp_sendrow
  49. .mc
  50.