DataObject.GetAttachedMatrix

Prototypes

void GetAttachedMatrix( String sName, Matrix m )

Parameters

String sName
The name of the attachment.

Matrix m
Upon return, contains the attached matrix. If there is no attachment with the specified name, the matrix is undefined (freed).

Remarks

This method retrieves the attachment with the specified name. The attachment must have been added using the method AddAttachedMatrix.

The DataObject class enables you to add attachments to a DataObject. This enables you to associate additional information about the data in a DataObject with the DataObject itself. The DataObject does not use your attachments. Note that attachments exist only in memory. They are not stored when you store the DataObject.

Example
declare DataObject dobj = DataObject.Create( "Example" );
x = rannor( 1:100 );
dobj.AddVar( "X", x );

minmax = x[><] // x[<>];
dobj.AddAttachedMatrix( "X MinMax", minmax );

dobj.GetAttachedMatrix( "X MinMax", xmm );
print xmm;
See Also

DataObject.AddAttachedMatrix