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

◆ CreateTopLevelArray() [1/2]

template<class ContainerType >
static Id drama::sds::Id::CreateTopLevelArray ( const std::string &  name,
const SdsCodeType  code,
const ContainerType dims,
const std::string &  extra = "" 
)
inlinestatic

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

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

Warning
Some compilers will try to use this overload of this method when the 4th argument (dims) is NOT a container, the intent would be to invoke the other overload where that argument is an unsigned int item (single dimensional version). The solution is to ensure the argument is cast explicitly to "unsigned".
See also
SdsNew()
Parameters
nameThe name for the new SDS item.
codeThe SDS code for the new item.
dimsA container giving each dimension. A maximum of 7 dimensions are supported
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.