skip to main content
OpenAccess SDK SQL Engine Core Functions API : Function Reference : dam_addCharValToRow
 

dam_addCharValToRow

This function is used to build up a row by adding values for columns, one at a time. This function requires all data to be passed in using the same format as the column definition in the schema database or in any format for which a conversion is supported. Please refer to the following data conversion table:
http://www.datadirect.com/download/docs/openaccess/alloa/dataconversiontable.htm
Character data can be added by supplying the length or by marking the data as null terminated. NULL data is added by specifying the XO_NULL_DATA value flag for the column value length.
These methods copy data from the user-supplied buffer to its internal buffers; therefore, the IP can free the memory associated with the input buffer (colVal).
int dam_addCharValToRow(
int64 hstmt,
int64 hRow,
int64 hCol,
String colVal,
int lColValLen)
Table 52. Parameters for dam_addCharValToRow
Parameter
Type
Description
IN
hstmt
int64
The statement handle
hRow
int64
The row handle
hCol
int64
The column handle
colVal
depends on the method used
The type of the data should correspond to the iXoType value.The data can be supplied in a format that corresponds to the column's definition in the schema or in any other format and the OpenAccess SDK SQL engine will perform the required conversion.
IColValLen
int
The length of the data
XO_NULL_DATA - indicates a null value
For VARCHAR, CHAR, WVARCHAR, WCHAR, and NUMERIC, either the number of characters or XO_NTS to add the entire string.
For all other data types, 0 or any value other than XO_NULL_DATA.
RETURN
int
DAM_SUCCESS - added the value to the row
DAM_FAILURE - error adding the value