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

◆ CreateTopLevelArray() [2/2]

static Id drama::sds::Id::CreateTopLevelArray ( const std::string &  name,
const SdsCodeType  code,
const unsigned  nElem,
const std::string &  extra = "" 
)
inlinestatic

Factory constructor method Constructor which creates a new one-dimensional array top-level item.

This static factory sds::Id constructor creates a new SDS array which is a top-level SDS item.

Warning
nElem argument can give problems in resolving this overload versions the other overload of this name. That other overload accepts a container in that position and sometimes compilers default to that rather then this method. The solution is to ensure the nElem argument is cast explicitly to "unsigned".
See also
SdsNew()
Parameters
nameThe name for the new SDS item.
codeThe SDS code for the new item.
nElemThe number of elements in the array.
extraThe extra data, if any. Defaults to none.
Template Parameters
ContainerTypeA container with a size() method and which can be used to initialize a vector of unsigned long.
Returns
An Id providing a reference to the array.

References drama::CreateRunDramaTask(), and DramaTHROW_S.