Cell (by Row/Column Name)
Purpose
Function for getting or setting individual cell values by row number and column name.
Syntax
CRfcData& Cell(int nRow, CSTR strFieldName);
Parameters
Return Value
Reference to a CRfcData object containing the data value and type information.
Exceptions
Throws const char* if no field information can be found for the specified column.
Throws const char* if no such row can be found.
Description
Use this function to assign and retrieve values from any cell through the support of CRfcData. User should not be concerned with or make any direct use of the intermediate CRfcData object.
To be able to access a cell value, information about the corresponding column or field should have been already supplied to the parameter object using either of the CRfcComplexParam::AddFieldInfo functions.
Note that cell by cell operations on the same row should be done through the functions SetCurrentRow and Field to achieve better performance.
Assuming ATableParam is a table parameter with column named NUMBER of type RFC_INT:
ATableParam.Cell(0, "NUMBER") = 5; // Sets table cell at row 0, // column NUMBER to value 5. int anInt = ATableParam.Cell(0, "NUMBER"); // Retrieves table cell at // row 0, column NUMBER, and // assigns it to anInt.
|
Related Information
AddFieldInfo (Multiple Fields) AddFieldInfo (Single Field)Field (Constant Table, by Index/Column Name Field (Constant Table, by Index/Column Number) Field (by Row/Column/Field Name) Field (by Row/Column Number)
Cell (by Row/Column Number) Cell (Constant Table, by Row/Column Name) Cell (Constant Table, by Row/Column Number)