ThingWorx C SDK
Macros
InfoTable Creation Macros

Macros

#define TW_DECLARE_IT_ROW(primitive, ...)   twInfoTable_CreateRowFromEntries(primitive,##__VA_ARGS__,VAR_ARG_END)
 Creates an InfoTableRow structure on the heap and returns it. Most often used in the construction of InfoTables using the TW_MAKE_INFOTABLE() macro. More...
 
#define TW_IT_ROW(primitive, ...)   twInfoTable_CreateRowFromEntries(primitive,##__VA_ARGS__,VAR_ARG_END)
 A short version of TW_DECLARE_IT_ROW. Creates an InfoTableRow structure on the heap and returns it. Most often used in the construction of InfoTables using the TW_MAKE_INFOTABLE() macro. More...
 
#define TW_MAKE_INFOTABLE(dataShape, ...)   twInfoTable_CreateInfoTableFromRows(dataShape,##__VA_ARGS__,VAR_ARG_END)
 Creates an InfoTable structure on the heap. Should be used in conjunction with TW_IT_ROW() and TW_MAKE_DATASHAPE() to simplify the creation of complete InfoTables. More...
 
#define TW_MAKE_IT(dataShape, ...)   twInfoTable_CreateInfoTableFromRows(dataShape,##__VA_ARGS__,VAR_ARG_END)
 A shorter version of TW_MAKE_INFOTABLE. Creates an InfoTable structure on the heap. Should be used in conjunction with TW_IT_ROW() and TW_MAKE_DATASHAPE() to simplify the creation of complete InfoTables. More...
 

Detailed Description

Macro Definition Documentation

#define TW_DECLARE_IT_ROW (   primitive,
  ... 
)    twInfoTable_CreateRowFromEntries(primitive,##__VA_ARGS__,VAR_ARG_END)

Creates an InfoTableRow structure on the heap and returns it. Most often used in the construction of InfoTables using the TW_MAKE_INFOTABLE() macro.

Parameters
primitivetwPrimitive* [in] A list of one or more primitives to be used to populate the row being created.
Returns
twInfoTableRow* the created row containing all the primitives passed in the argument list.
#define TW_IT_ROW (   primitive,
  ... 
)    twInfoTable_CreateRowFromEntries(primitive,##__VA_ARGS__,VAR_ARG_END)

A short version of TW_DECLARE_IT_ROW. Creates an InfoTableRow structure on the heap and returns it. Most often used in the construction of InfoTables using the TW_MAKE_INFOTABLE() macro.

Parameters
primitivetwPrimitive* [in] A list of one or more primitives to be used to populate the row being created.
Returns
twInfoTableRow* the created row containing all the primitives passed in the argument list.
#define TW_MAKE_INFOTABLE (   dataShape,
  ... 
)    twInfoTable_CreateInfoTableFromRows(dataShape,##__VA_ARGS__,VAR_ARG_END)

Creates an InfoTable structure on the heap. Should be used in conjunction with TW_IT_ROW() and TW_MAKE_DATASHAPE() to simplify the creation of complete InfoTables.

Parameters
dataShapetwDataShape* [in] A datashape that describes each row of this InfoTable.
infoTableRowtwInfoTableRow* [in] A list of 0 or more InfoTable rows that conform to dataShape.
Returns
twInfoTable* the created InfoTable containing all the rows passed in the argument list.
#define TW_MAKE_IT (   dataShape,
  ... 
)    twInfoTable_CreateInfoTableFromRows(dataShape,##__VA_ARGS__,VAR_ARG_END)

A shorter version of TW_MAKE_INFOTABLE. Creates an InfoTable structure on the heap. Should be used in conjunction with TW_IT_ROW() and TW_MAKE_DATASHAPE() to simplify the creation of complete InfoTables.

Parameters
dataShapetwDataShape* [in] A datashape that describes each row of this InfoTable.
infoTableRowtwInfoTableRow* [in] A list of 0 or more InfoTable rows that conform to dataShape.
Returns
twInfoTable* the created InfoTable containing all the rows passed in the argument list.