solidDB Help : solidDB reference : solidDB SA: Function reference : SaCursorColDynStr
  
SaCursorColDynStr
SaCursorColDynStr binds a user variable of type SaDynStrT to a database column.
In search operations, the user variable is updated to contain the value of the current row. Also, if search criteria are involved, this function is used to pass the values for them. In insert and update operations, the new value for the column is taken from the user variable.
In search operations, the column data is stored to the SaDynStrT variable using function SaDynStrMove, which overwrites the old data. The user is responsible for releasing the SaDynStrT variable after the search ends using function SaDynStrFree.
The user can bind an SaDynStrT variable to any type of column (not just character columns) and the data will be converted back and forth between the column type and the Dynamic String type.
Dynamic String objects (SaDynStrT) are an abstraction that simplifies the handling of variable length strings. Typically, the functions SaDynStrMove and SaDynStrAppend are used to set and modify the data value inside the dynamic string object. More memory will be automatically allocated when necessary and all the associated memory will be automatically deallocated when the dynamic data object is disposed of using SaDynStrFree.
See SaCursorColDynData for a more detailed discussion of binding variables.
Synopsis
SaRetT SA_EXPORT_H SaCursorColDynStr(
  SaCursorT* scur,
  char* colname,
  SaDynStrT* ds)
Parameters
The following table describes the parameters:
 
Parameters
Usage type
Description
scur
in, use
Pointer to a cursor object
colname
in, use
Column name
ds
in, hold
Pointer to the user variable
Return value
SA_RC_SUCC or error code.
Go up to
solidDB SA: Function reference