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


Home MathPack Matrix Classes TIntMatrix, TMatrix and TMat3D Methods ReadFromXMLStream
See also: WriteToXMLStream, DataID, ReadFromOpenXMLFile, LoadFromXMLFile, SaveAsXMLFile, WriteToOpenXMLFile, TMatXmlTag, DataID (Mat4D) 

ReadFromXMLStream


Unit:SDL_matrix
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: 2023-Feb-06