The SDL Component Suite is an industry leading collection of components supporting scientific and engineering computing. Please visit the SDL Web site for more information....


Class:TMatrix, TIntMatrix, TMat3D
Declaration:function ReadFromXMLStream (InStream: TStream; DataID: string): boolean;

The function ReadFromXMLStream reads the data from the current position of the stream InStream. If the parameter DataID is empty, the first <matrix> tag is evaluated and read into the matrix. If DataID is not empty, the entire rest of the stream is read until a <matrix> tag is found whose attribute "id " matches DataID (the recognition of the "id " attribute is not case-sensitive). The property DataID is set to the identification string of the XML data source. The function ReadFromXMLStream returns TRUE if both a valid starting tag <matrix> and a valid end tag </matrix> has been found and the matrix has been updated. In this case the OnChange event is triggered.

Hint 1: The XML description of the matrix data has to follow a certain order: number of columns and rows have to precede all other data.

Hint 2: ReadFromXMLStream is by a factor of 5 slower than ReadFromOpenXMLFile. Thus you should avoid to use ReadFromXMLStream when reading large matrices with more than approx. 10000 cells.

Last Update: 2012-Oct-20