Find()

virtual Id drama::sds::Id::Find ( const std::string &  name, bool  throwOnNotFound = true  ) const

virtual

Factory constructor method Constructor which returns a reference to a named item.

This non-static factory constructor searches an existing SDS item for a item with a specified name and creates a reference to it, which is returned.

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

See also

SdsFind()

Parameters

name	The name of the SDS item to find.
throwOnNotFound	If true (default), will throw an exception if the an item of the name specified does not exist. Otherwise will return a null SDS item. Any other errors will cause an exception to be thrown regardless.

Returns

An Id providing a reference to the item.

Referenced by DeleteIfExists(), drama::ArrayParameter< SDS_T >::Fill(), drama::ArrayParameter< SDS_T >::Get(), Put(), Put(), drama::ArrayParameter< SDS_T >::Set(), drama::ArrayParameter< std::string >::Set(), and drama::ArrayParameter< SDS_T >::Set().