CreateChildArray() [2/2]

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

inline

Factory constructor method Constructor which creates a new child item which is a one-dimensional array.

This non-static factory sds::Id constructor creates a new SDS array item which is a child of this SDS item.

The object on which the method is invoked must reference an SDS Structure item (rather then an array or primitive). It must also be an internal item (rather then external).

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

name	The name for the new SDS item.
code	The SDS code for the new item.
nElem	The number of elements in the array.
extra	The extra data, if any. Defaults to none.

Template Parameters

ContainerType

A 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_F.