AAO DRAMA/DRAMA2 C++ Interface
DRAMA C++11 and later interface

◆ Put() [2/5]

template<typename T >
void drama::sds::Id::Put ( const std::string &  name,
value,
const std::string &  extraData = "" 
)
inline

Insert a primitive value into a named component of the structure.

The named item is created in the SDS structure if it does not already exist and the specified value inserted.

If the named item already exists, then the value is converted to that type (if possible) and inserted.

Supports the various primitive types - bool, char, short, unsigned short, INT32, UINT32, INT64, UINT64, float and double. Also the string representations char* and std::string.

bool is represented by an SDS type SDS_USHORT.
char * and std::string are put in arrays of SDS_CHAR items.

This is equivalent to the ArgPut series of C level calls, used for building up DRAMA command arguments.

Template Parameters
TThe SDS primitive you wish to insert.
Parameters
nameThe name of the item within the SDS structure.
valueThe value to be inserted.
extraDataIf not an empty string, then this value is put as the SDS extra string associated with this item.

References drama::CreateRunDramaTask(), DramaTHROW_S, and Find().